adding the AGAIN control word
[rrq/rrqforth.git] / adoc / p_again.adoc
1 // control.asm: WORD p_again,'AGAIN',fasm
2
3 anchor:p_again[]
4
5 === Word: AGAIN
6
7 ....
8 Data stack: Compiling: ( -- a )
9 ....
10
11 "AGAIN" is an immediate function word that is used together with
12 <<p_begin,BEGIN>> and instead of <<p_end,END>> to implement structured
13 execution control. AGAIN scans the datastack for the nearest preceding
14 BEGIN marker and lays out an unconditional branch from this point the
15 beginning of the block during execution. It thereafter performs the
16 <<p_end,END>> compile action to end the block.