The <<cgi...>> function can operate with either a single unnamed argument, or with many arguments in name-and-value pairs. If a single stringArg is given, it expands to a string that has all characters converted to CGI scoped values. If one or more name and value pair arguments are given, they are formatted to a string that is the named pairs, joined by ampersands (&), with the values CGI escaped.
The CGI function escapes strings following the CGI conventions certain characters are replaced with a % followed by two hexadecimal digits that are the ASCII value for the character.
The stringArg will have any characters it contains escaped according to CGI conventions. The name-and-value pairs will be formatted into named parameters and values, with the values also escaped according to CGI standards. The order of the named parameters is not preserved when this function is expanded. Also, the CGI function escapes spaces with %20's rather than with +'s. Both are allowed by the CGI convention.
- <<cgi stringArg>>
--OR-- <<cgi named1=value [named2=value...namedN=value]>>
- stringArg A text string that will be escaped according to CGI conventions. This may be a hard coded value, a data tag, or the return value of a function.
- named1-n A named parameter to be returned with a value that will be formatted according to CGI conventions. May be a hard coded value, a data tag, or the return value of a function.
- value A value to the corresponding named parameters that will be formatted according to CGI conventions. May be a hard coded value, a data tag, or the return value of a function.