<@SEARCHARG>
Syntax
<@SEARCHARG NAME=name
[TYPE=type] [FORMAT=format]
[ENCODING=encoding]>
Description
Returns the value(s) of the named search
argument (name/value pairs after a "?" in the URL, or form
fields in a GET method form) in the HTTP request calling the
application file. References to search 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 search argument. A URL like
http://www.yoursite.com/my.taf?x=1&x=2&x=3, for
example, sends three separate values for the x search argument. 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
The items in the <@SEARCHARG
NAME="category_name"> category are:
<@ROWS>
<@COLUMN NAME="product.name"><BR>
</@ROWS>
This example includes the requested
category name in a heading prior to listing the products.
See Also
<@ARG>
Encoding Attribute
Format Attribute
<@POSTARG>
|