Technical References - [listvariables]

Lists all the text and/or math variables which have been set earlier on a page.

[listvariables options]Variable Tags[/listvariables]

To display a list of all the text or math variables available, put a [listvariables] context into a template.

Example:

The following are all the text and math variables available to this page:
[listvariables]
[index],[name],[value]
[/listvariables]

The [listvariables] context has optional parameters that are placed within the beginning tag in order to modify the list of variables produced.

Example:

The following are the values of all the text variables created on this template so far:
[listvariables type=text]
[index],[name],[value]
[/listvariables]


The following are the values of all the math variables created on this template whose variable name begins with "fred":
[listvariables type=math&name=fred]
[index],[name],[value]
[/listvariables]

Listing the variables with a given name is useful for displaying arrays of variables.

The following parameters are optional to the [listvariables] context:
ParameterDescription
Name(Optional) The name of the variable to list.
Exact(Optional) T(rue) or F(alse) whether to exactly match the name of the variable or match any name containing the "name" value. (Default value is true.)
Type(Optional) Text or Math. Default is to list variables of both types, but if you specify Text then only Text variables will be listed, and if you specify Math then only Math variables will be listed.


The following tags are available inside a [listvariables] context:
TagDescription
[name]The name of the variable.
[value]The value associated with the variable.
[index]A number from 1 to the total number of variables, indicating this field's index position in the list
[secure]Displays "T" if the variable is secure, "F" otherwise.
[break]From version 8.1, if the [listvariables] context sees the [break] tag while executing a loop, it will stop looping, once it finishes the current loop. Thus the [break] tag should only appear in a [showif] statement that is evaluated at the end (bottom) of the loop.



DOWNLOAD WEBDNA NOW!

Top Articles:

WebDNA Libraries

A list of available libraries for WebDNA...

Technical Change History

This Technical Change History provides a reverse chronological list of WebDNA changes...

Download WebDNA Applications

WebDNA applications...

WebDNA Modules

A list of the currently available modules...

F.A.Q

A compilation of some user's questions...

Tips and Tricks

A list of user-submitted tips ...

Related Readings:

[listfields]

Lists all the fields in the specified database...

[renamefile]

Rename a file in your webspace...

[listchars]

Breaks a string of text into separate characters...

[setheader]

Changes header values in a shopping cart...

[SQLresult]

...

[SQL]

Performs a SQL statement on an ODBC data source...