User Guide

GetEncoding 487
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.");
WriteOutput("The encoding is " & theEncoding);
</cfscript>
</cfif>
Parameter Description
scope_name • Form
• URL.