Lotus Software logo
IBM Lotus Domino Designer 8.5
  Versions 8.5 and 8.5.1






@While

Executes one or more statements iteratively while a condition remains true. Checks the condition before executing the statements.

Note This @function is new with Release 6.

Syntax

@While( condition ; statement ; ... )

Parameters

condition

Expression that returns a value of True (1) or False (0).

statement

A formula language statement. The maximum number of statements you can include is 254.

Return value

true

True (1) unless an error occurs during execution of the condition. An "unexpected data type" error occurs if the conditional expression results in a non-numeric value.

Usage

@While evaluates the condition. If the condition is True (1), @While executes the statements then evaluates the condition again. If the condition is False (0), @While terminates.

Tip If you are looping through a field containing a list, be sure the Allow multiple values check box is selected in the Field Properties box for the list field.

For other iterative statements, see @DoWhile and @For.

Language cross-reference

While statement of LotusScript language

Do statement of LotusScript language

See examples

Examples: @While
Related topics
Using iterative statements
Temporary variables
List subscript operator




Library | Support | Terms of use |

Last updated: Monday, October 5, 2009