| URLENCODEDFORMAT | |
| Description
Generates a URL-encoded string. For example, it replaces spaces with %20, and non-alphanumeric characters with equivalent hexadecimal escape sequences. Passes arbitrary strings within a URL (ColdFusion automatically decodes URL parameters that are passed to a page). |
|
| Returns
A copy of a string, URL-encoded. |
|
| Category
Conversion functions, Other functions, String functions |
|
Function syntaxURLEncodedFormat(string [, charset ]) |
|
| See also
URLDecode; "Tags and functions for globalizing" in Chapter 17, "Developing Globalized Applications," in ColdFusion MX Developer's Guide |
|
| History
ColdFusion MX 6.1: Changed the default encoding to be the response character encoding. ColdFusion MX: Added the charset parameter. |
|
| Parameters
|
|
| 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<h3>URLEncodedFormat Example</h3>
<cfif IsDefined("url.myExample")>
<p>The url variable url.myExample was passed from the previous link ...
its value is:
<br><b>"<cfoutput>#url.myExample#</cfoutput>"</b>
</cfif>
<p>This function returns a URL encoded string.
<cfset s = "My url-encoded string has special characters & other stuff">
<p> <A HREF = "urlencodedformat.cfm?myExample=<cfoutput>#URLEncodedFormat(s)#
</cfoutput>">Click me</A>
|
|
| STRING | |
| CHARSET | |