Try OpenEdge Now
skip to main content
Developing WebSpeed Applications
WebSpeed API Reference : url-format
 

url-format

This function formats a URL and arguments for all the specified fields that result in non-blank values. It returns a series of name\value pairs suitably encoded and delimited to send to a browser.

Location

web\method\cgiutils.i

Parameters

INPUT p_url AS CHARACTER
A URL without arguments or query strings. If a Unknown value (?) is specified for the URL, the value of the global variable SelfURL is used, which is the URL of the currently executing Web object without the host name and port number.
INPUT p_name-list AS CHARACTER
A character expression containing a comma-delimited list of field names available through the get-value function.
INPUT p_delim AS CHARACTER
The delimiter to use between name\value pairs. If the Unknown value (?) is specified, the default is & which is appropriate if the resulting URL is output to the browser.

Returns

CHARACTER

Notes

The value associated with each field name is determined by calling the get-value API function.

Examples

{&OUT} url-format("custdetail.html","name,custnum",?).

See also

url-field-list
get-value
url-field
hidden-field-list