Technical References - [listvariables]

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

numero = 252
interpreted = N
texte = [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:

Parameter	Description
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:

Tag	Description
[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.

 [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:

Parameter	Description
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:

Tag	Description
[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 reference

...

Technical Change History

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

Download WebDNA Applications

WebDNA applications...

F.A.Q

A compilation of some user's questions...

WebDNA Libraries

A list of available libraries for WebDNA...

Tips and Tricks

A list of user-submitted tips ...

Related Readings:

[raw]

Displays enclosed text without interpreting the [xxx] tags in any way...

[store]

[store] is a simple context that stores variables permanently...

[protect]

...

[return]

Explicitly identify what text is returned from a function call...

[movefile]

This instructions move a file from one location to another...

[username]

Using [password] and [username] is an easy was to show the browser login dialog box...