ITERATE statement

Purpose

Start an immediate iteration of a loop structure.

Syntax

ITERATE [DO | LOOP | FOR]

Remarks

ITERATE is just like using a GOTO to the line immediately before the NEXT statement (of a FOR...NEXT loop), the LOOP statement (of a DO...LOOP loop), or the WEND statement (of a WHILE..WEND loop).  For example, the following code fragments are equivalent:

FOR ix = 1 TO 100

  [statements]

  ITERATE FOR

  [statements]

NEXT

FOR ix = 1 TO 100

  [statements]

  GOTO iterateForLoop

  [statements]

iterateForLoop:

NEXT

If you do not specify DO, LOOP, or FOR, ITERATE will iterate the most recently executed structure.  For example:

FOR ix = 1 TO 10

  DO UNTIL x > 10

    [statements]

    ITERATE  ' will iterate the DO LOOP

    [statements]

  LOOP

NEXT

ITERATE DO and ITERATE LOOP are interchangeable.

See also

DO/LOOP, EXIT, FOR EACH/NEXT, FOR/NEXT, WHILE/WEND