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
Parameter | Description
scope_name | Form
| URL.
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 |
Form URL.