Lingo Dictionary > T-Z > URLEncode

 

URLEncode

Syntax

URLEncode(proplist_or_string {, serverOSString} {, characterSet}) 

Description

Function; returns the URL-encoded string for its first argument. Allows CGI parameters to be used in other commands. The same translation is done as for postNetText and getNetText() when they are given a property list.

Use the optional parameter serverOSString to encode any return characters in proplist_or_string. The value defaults to "Unix" but may be set to "Win" or "Mac" and translates any carriage returns in the proplist_or_string argument into those used on the server. For most applications, this setting is unnecessary because line breaks are usually not used in form responses.

The optional parameter characterSet applies only if the user is running on a Shift-JIS (Japanese) system. Its possible settings are "JIS", "EUC", "ASCII", and "AUTO". Retrieved data is converted from Shift-JIS to the named character set. Returned data is handled exactly as by getNetText() (converted from the named character set to Shift-JIS). If you use "AUTO", the posted data from the local character set is not translated; the results sent back by the server are translated as they are for getNetText(). "ASCII" is the default if characterSet is omitted. "ASCII" provides no translation for posting or results.

Example

In the following example, URLEncode supplies the URL-encoded string to a CGI query at the specified location.

URL = "http://aserver/cgi-bin/echoquery.cgi"
gotonetpage URL & "?" & URLEncode( [#name: "Ken", #hobby: "What?"] )

See also

getNetText(), postNetText