<@POSTARG>

Syntax

<@POSTARG NAME=name [TYPE=type] [FORMAT=format]
[ENCODING=encoding]>

Description

Returns the value(s) of the named post argument (form field) in the HTTP request calling the application file. References to post arguments not present in the request evaluate to empty.

The NAME attribute may be specified as a literal value, value-returning meta tag, or a combination of both.

The TYPE attribute accepts one of two possible values: TEXT or ARRAY. ARRAY causes the tag to return a single-column, multi-row array of values, one for each value received for the named post argument. A <SELECT> form field with the MULTIPLE attribute, for example, sends multiple instances of the form field, one for each value selected by the user. Using the ARRAY type lets you access all those values. TEXT, which is the default type if the TYPE attribute is not specified, causes the tag to return a single value. If you specify this type when multiple values were received for the argument, the value returned is the first one received by Tango.

The optional FORMAT and ENCODING attributes determine how the value is formatted by Tango. These attributes are ignored if TYPE=ARRAY is specified.

Example

You asked for properties in <@POSTARG NAME="city">

This example includes the value from the form field "city" in the HTML.

See Also

<@ARG>
Encoding Attribute
Format Attribute
<@POSTARGNAMES>
<@SEARCHARG>
<@SEARCHARGNAMES>