setEncoding

Sets the character encoding (character set) of Form and URL
scope variable values; used when the character encoding of
the input to a form, or the character encoding of a URL, is
not in UTF-8 encoding.

setEncoding(scope_name, charset) → returns void

setEncoding Argument Reference

scope_name
Required

charset
Required

The character encoding in which text in the scope
variables is encoded. Values:
  • utf-8
  • iso-8859-1
  • windows-1252
  • us-ascii
  • shift_jis
  • iso-2022-jp
  • euc-jp
  • euc-kr
  • big5
  • euc-cn
  • utf-16

Examples sample code invoking the setEncoding function


Script Example

<!--- This example sends and interprets the contents of two fields as big5 encoded text. Note that the form fields are received as URL variables because the form uses the GET method. ---> 
 <cfcontent type="text/html; charset=big5"> 
 <form action='#cgi.script_name#' method='get'> 
 <input name='xxx' type='text'> 
 <input name='yyy' type='text'> 
 <input type="Submit" value="Submit"> 
 </form> 
 <cfif isDefined("URL.xxx")> 
 <cfscript> 
 setEncoding("url", "big5"); 
 writeOutput("URL.XXX is " & URL.xxx & "<br>"); 
 writeOutput("URL.YYY is " & URL.yyy & "<br>"); 
 theEncoding = getEncoding("URL"); 
 writeOutput("The URL variables were decoded using '" & theEncoding & "' encoding."); 
 writeOutput("The encoding is " & theEncoding); 
 </cfscript> 
 </cfif>

Fork me on GitHub