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).
A copy of a string, URL-encoded.
Conversion functions, Other functions, String functions
URLEncodedFormat(string [, charset ])
New in ColdFusion MX: the charset
parameter is new.
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.
<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>