<@NEXTVAL>

Syntax

<@NEXTVAL NAME=variable [SCOPE=scope] [STEP=increment]>

Description

Increments the specified variable by the specified increment and returns the new value. <@NEXTVAL> operates only on integer values. The default increment is "1", if no STEP is specified. You can specify a variable scope as well; see <@VAR> for a explanation of scoping rules.

If the variable does not exist, is non-integer, is not scalar, or if the step is non-integer, <@NEXTVAL> evaluates to nothing, and an error is logged if LogLevel is greater than 0.

Scalars or individual array items may be updated by <@NEXTVAL>.

Example

Placing the following line in the Results HTML after each database access (Search, New Record, and so on) returns the number of times the user has accessed the database in their session:

<P>You have accessed the database
<STRONG><@NEXTVAL NAME="user$access"></STRONG> times in this session.</P>

See Also

loggingLevel
<@VAR>