URLDecode |
Description
Decodes a URL-encoded string.
Returns
A copy of a string, decoded.
Category
Conversion functions, Other functions, String functions
Function syntax

    URLDecode(urlEncodedString[, charset])

See also
URLEncodedFormat
History
ColdFusion MX 6.1: Changed the default charset: the default charset is the character encoding of the URL scope.

ColdFusion MX:

- Changed Unicode support: ColdFusion supports the Java UCS-2 representation of Unicode character values 0-65535. (Earlier releases supported ASCII values.)
- Added the charset parameter.

Parameters

Parameter | Description
urlEncodedString | URL-encoded string or a variable that contains one.
charset | The character encoding in which the URL is encoded. Optional.
| The following list includes commonly used values::
| utf-8
| iso-8859-1
| windows-1252
| us-ascii
| shift_jis
| iso-2022-jp
| euc-jp
| euc-kr
| big5
| euc-cn
| utf-16
| For more information on character encodings, see:
| www.w3.org/International/O-charset.html.
| Default: the character encoding of the URL scope. See SetEncoding
| on page 693.

Usage
URL encoding formats some characters with a percent sign and the two-character hexadecimal representation of the character. For example, a character whose code is 129 is encoded as %81. A space is encoded with a plus sign.
Query strings in HTTP are always URL-encoded.
Example

This example creates, encodes, and decodes a string that contains ASCII character codes.

    <cfscript>
       // Build string
       s = "";
       for (c = 1; c lte 256; c = c + 1)
       {
          s = s & chr(c);
       }
       // Encode string and display result
       enc = URLEncodedFormat(s);
       WriteOutput("Encoded string is: '#enc#'.<br>");
       // Decode and compare result with original
       dec = URLDecode(enc);
       if (dec neq s)
       {
          WriteOutput("Decoded is not the same as encoded.");
       }
       else
       {
          WriteOutput("All's quiet on the Western front.");
       }
    </cfscript>

urlEncodedString |
URL-encoded string or a variable that contains one.

charset |
The character encoding in which the URL is encoded. Optional.

The following list includes commonly used values:

- utf-8
- iso-8859-1
- windows-1252
- us-ascii
- shift_jis
- iso-2022-jp
- euc-jp
- euc-kr
- big5
- euc-cn
- utf-16

For more information on character encoding, see: http://www.w3.org/International/O-charset.html.
Default: the character encoding of the URL scope. See SetEncoding.