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.