Gambas Documentation - /lang/for

/lang/for

# FOR

FOR Variable = Expression { TO | DOWNTO } Expression [ STEP Expression ] ... NEXT

Repeats a loop while incrementing or decrementing a variable.

The loop variable must be:

- Numeric, i.e. a Byte, a Short, an Integer, a Long or a Float number.

- A local variable.

If DOWNTO is used instead of TO, then the increment step is reversed.

If the initial expression is higher than the final expression (for positive STEP values), or if the initial expression is less than the final expression (for negative ones) the loop will not be executed at all.

### Examples

    DIM iCount AS Integer

    FOR iCount = 1 TO 20 STEP 3
      PRINT iCount;;
    NEXT
    -
    1 4 7 10 13 16 19

### Examples

    FOR iCount = 10 DOWNTO 1
      PRINT iCount;;
    NEXT
    10 9 8 7 6 5 4 3 2 1

    FOR iCount = 10 DOWNTO 1 STEP 3
      PRINT iCount;;
    NEXT
    10 7 4 1

### See also

- Loop Control Structures