For field value

Command groupFlag affectedReversibleExecute on clientPlatform(s)
ConstructsNONOYESAll

Syntax

For
 
field-name
 
from
 
start
 
to
 
stop
 
step
 
step

Description

This command marks the beginning of a For loop which defines a series of commands to be repeated a number of times. You use field-name as a counter that is automatically incremented by the step value each time the End For statement is reached.

The values involved must all be numbers, preferably integers. If start value is greater than end value, and step value is positive, the command will perform no loops. Similarly, no loops are performed if start value is less than end value, and step value is negative.

The end value is evaluated once at the start of the loop, and saved, for performance reasons, so changing the end value during the loop will have no effect. You can use Jump to start of loop within the loop to continue the next iteration of the loop. Similarly, you can terminate the loop early using Break to end of loop if desired.

Example

Calculate
 
lString
 as 
''

For
 
lCount
 
from
 
0
 
to
 
9
 
step
 
1

  
Calculate
 
lString
 as 
con
(
lString
,
lCount
)

End For
OK message
 
{
String=[
lString
]
}
 
## shows 'String=0123456789'

 
Calculate
 
lString
 as 
''

For
 
lCount
 
from
 
9
 
to
 
0
 
step
 
-1

  
Calculate
 
lString
 as 
con
(
lString
,
lCount
)

End For
OK message
 
{
String=[
lString
]
}
 
## shows 'String=9876543210'