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