URLDecode

Description

Decodes a URL-encoded string.

Syntax

URLDecode(urlEncodedString)

Parameters

Parameter

Description

urlEncodedString
A string that has been URL-encoded.

Parameter	Description
urlEncodedString	A string that has been URL-encoded.

Usage

URL encoding is a data format in which high ASCII and nonalphanumeric characters are encoded using a percent sign followed by the two character hexadecimal representation of the character code. For example, a character with code 129 is encoded as %81. Spaces can be encoded using the plus sign (+).

Query strings in HTTP are always URL-encoded.

URL-encoded strings can be created with the URLEncodedFormat function.

Example

Here is an example of the URLDecode and URLEncodedFormat functions. In the example, a string that contains all ASCII character codes in the range 1-255 is created, encoded and decoded. The decoded value is compared with the original string to demonstrate their equality.

<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 well on the Western front.");
  }
</cfscript>