Start loop

Purpose: Loop execution based on a condition.

start-loop  [ repeat <repeat> ] \
    [ use <loop counter> \
        [ start-with <start with> ] [ add <add> ] ]

    <any code>

end-loop

Copied!

start-loop will execute code between start-loop and "end-loop" clauses certain number of times based on a condition specified and the usage of continue-loop and break-loop, which can be used in-between the two.

<repeat> number (in "repeat" clause) specifies how many times to execute the loop (barring use of continue-loop and break-loop).

<loop counter> (in "use" clause) is a number that by default starts with value of 1, and is incremented by 1 each time execution loops back to start-loop, unless "start-with" and/or "add" clauses are used. The end value of <loop counter> (just outside "end-loop") is the first value past the last loop.

If <start with> (in "start-with" clause) is used, that's the initial value for <loop counter> (instead of the default 1), and if <add> is specified (in "add" clause), then <loop counter> is incremented by <add> each time execution loops back to start-loop (instead of the default 1). <add> can be positive or negative.

If either of "start-with" or "add" clauses is used, then "use" must be specified.

Examples

Print numbers 0 through 19:

start-loop repeat 20 use p start-with 0
    print-out p
    @
end-loop

Copied!

A loop that is controlled via continue-loop and break-loop statements, displaying numbers from 1 through 30 but omitting those divisible with 3:

set-number n
set-number max = 30
start-loop
    set-number n add 1
    if-true n every 3
        continue-loop
    end-if
    if-true n greater-than max
        break-loop
    end-if
    print-out n
end-loop

Copied!