NEXT Command

Description:

This command loads a variable with the next sequential value from a set of values. This could be either a list or a range associated with that variable, or from a file associated with the variable.

When the NEXT command is first executed, it will retrieve the first value. The set is treated as cyclic: when the last value has been retrieved, the next value retrieved will be the first in the set.

This command may be used to reset the value pointer associated with a variable so that the first NEXT command to be executed after the RESET retrieves the first value in the set.

The variable must have a set of values or a file associated with it in the Definitions section.

Format:

 NEXT variable

Parameter:

variable

The name of a variable into which the next value from the set is loaded. The variable must have a set of values or a file associated with it in the Definitions section.

Example:

 NEXT Emp-Name

See also:

Input Stream Entry Commands