For - Crestron SIMPL+ Reference Manual

Crestron SIMPL+
Language Reference Guide - DOC. 5797G
®

FOR

Name:
FOR
Syntax:
FOR (<variable> = <start_expression> TO <end_expression>
[STEP <step_expression>])
[{]
<statements>
[}]
Description:
This loop executes the <statements> while <variable> iterates from the value of
<start_expression> to the value of <end_expression>. The variable is incremented by
<step_expression> at the end of the loop, if STEP is specified, else it is incremented
by 1. The <step_expression> can be negative which will result in the loop counting
down. If only one statement is present in the body of the loop, then the { and }
characters are not required, but may be used. If more than one statement is present in
the loop body, then the { and } characters are mandatory. Note that
<start_expression> and <end_expression> are evaluated once before the loop starts
and are not re-evaluated during the execution of the loop. If it is defined,
<step_expression> is evaluated each pass through the loop, so <step_expression>
may be modified during execution of the loop.
In the 2-Series control systems, the <step_expression> cannot change its sign during
the execution of the loop. That is, if it is initially a positive number, then it is assumed
if it will always count up. If it is negative, it will always count down.
NOTE: If <variable> is set to a value greater than the <end_expression> within the
body of the FOR loop, the FOR loop will exit when it reaches the end.
At the end of the loop, the loop index has the value of <end_expression> + 1 (unless
the loop index was modified in the body of the loop).
The comparisons are based on signed numbers, the maximum loop size for a step of
one would be from 1 to 32767. If larger indices are needed, for example, from 1 to
60000 a DO-UNTIL or WHILE loop could be used.
Software
®
SIMPL+ 83