ColdFusion 9.0 Resources |
SetEncodingDescriptionSets 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. See alsoGetEncoding, cfcontent, cfprocessingdirective, URLDecode, URLEncodedFormat; Locales in the Developing ColdFusion Applications Parameters
UsageUse this function when the character encoding of the input to a form or the character encoding of a URL is not in UTF-8 encoding. For example, Traditional Chinese characters are often in Big5 encoding. This function resets URL and Form variables, so you should call it before using these variables (typically, in the Application.cfm page or Application.cfc file). Calling this function first also avoids interpreting the characters of the variables incorrectly. For more information on character encoding, see the following web pages:
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> |