<@ARG>
Syntax
<@ARG NAME=name
[TYPE=type] [FORMAT=format]
[ENCODING=encoding]>
Description
Returns the value(s) of the named search or
post argument in the HTTP request that calls the application file.
References to arguments not present in the request evaluate to empty.
Use this meta tag (rather than <@SEARCHARG>
or <@POSTARG>) when you want the flexibility of
passing a value to an application file via either a search or post
argument.
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 argument. An HTML <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 attribute
determines how the value is formatted by Tango. This attribute is
ignored if TYPE=ARRAY is specified.
Examples
<@ARG NAME="foo">
These return the value of the "foo"
argument. Even if more than one value was specified for foo,
only one is returned.
<@ARG NAME="foo" TYPE="ARRAY">
This example returns an array containing
all values for the "foo" argument.
See Also
Encoding
Attribute
Format Attribute
<@POSTARG>
<@SEARCHARG>
|