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>
SCOPE_NAME