Programmer Guide/Command Reference/FOR

The FOR executes the commands in the block enclosed by the FOR statement and the corresponding END as long as the (slightly misleadingly named) TO condition holds true.

FOR [ target := init ] TO condition STEP step
   // commands
   // ...
END

target

The incremental counter variable to initialize with the value init (e.g. #i).

init

The value with which to initialize the counter variable target (e.g. 0).

condition

The condition which should be tested at the start of each loop (e.g. $#i < 10). See Conditional Expressions for further information on conditional expressions.

step

The (slightly misleadingly named) step clause is an STx statement for incrementing the counter variable target at the end of each loop, e.g. the statement #i := int $#i+1.

FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1
    BUTIL MSGBOX MSG; #i = $#i
END

// an example without initialisation
FOR TO $#x > $#y STEP #i := int $#i + 1
   // do something here ...
END