FOR

From Macros Wiki
Jump to: navigation, search

Up

Command

FOR <loop variable> = <start> TO <end> [STEP <step value>]


The FOR command is used in conjunction with the NEXT command and is used to define a block of macro commands that are executed several times. You define a loop variable and an initial value for that variable. All of the macro commands following the FOR command and up to the matching NEXT command will be executed. When the NEXT command is reached, the loop variable will be adjusted by adding a step amount. The new value of the loop variable is compared with the end value for the loop and if the end value has not yet been reached, the macro will go back to the first line after the FOR command and start processing again.

Parameters

<loop variable>
A number variable.
<start>
Start value. The loop variable will initially be set to this start value
TO
used to separate the start and end values
<end>
End value. The loop will be repeated until the loop variable reaches this end value.
STEP
used to indicate that a step value other than 1 is to be used.
<value>
Step. Each time the loop is executed, the loop variable will modified by adding this step value.

Example

FOR I = 1 TO 3
FOR J = 2 TO 8 STEP 2


The first loop will execute 3 times, with I set to 1, 2 and 3.
The second loop will execute 4 times with J set to 2, 4, 6 and 8.
For an example macro see Modify_Op_Path Modify_op_path2 Explode_Shape Calc_Geo_Extents Cs_List Debug_Sel_geo Get_Op_Tool_Path Global_Local GlobalLocal_Sub.mac Print_Geo_Data_To_File Solid_Type Wg_List