MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 604 / 1108

604 Chapter 3: ColdFusion Functions
GetEncoding
Description
Returns the encoding (character set) of the Form or URL scope.
Returns
String; the character encoding of the specified scope.
Category
International functions , System functions
Function syntax
GetEncoding ( scope_name )
See also
SetEncoding
,
cfcontent
,
cfprocessingdirective
,
URLDecode
,
URLEncodedFormat
History
ColdFusion MX: Added this function.
Parameters
Usage
Use this function to determine the character encoding of the URL query string or the fields of a
form that was submitted to the current page. The default encoding, if none has been explicitly set,
is UTF-8.
For more information, see www.iana.org/assignments/character-sets .
Example
<!--- This example sends the contents of two fields and interprets them as
big5 encoded text. --->
<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.");
Parameter Description
scope_name
•
Form
•
URL.