adding the AGAIN control word
authorRalph Ronnquist <ralph.ronnquist@gmail.com>
Fri, 4 Jun 2021 08:29:57 +0000 (18:29 +1000)
committerRalph Ronnquist <ralph.ronnquist@gmail.com>
Fri, 4 Jun 2021 08:29:57 +0000 (18:29 +1000)
reference.html

index 0fc06e19112a3d6eea43df52850d7670d96558cd..609c422d1f31238ff88134fad393ef226287787e 100644 (file)
@@ -793,6 +793,7 @@ asciidoc.install();
 <a href="#p_2over">2OVER</a> &#160;\r
 <a href="#p_2swap">2SWAP</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_abs">ABS</a> &#160;\r
+<a href="#p_again">AGAIN</a> &#160;\r
 <a href="#p_allot">ALLOT</a> &#160;\r
 <a href="#p_and">AND</a> &#160;\r
 <a href="#inline_code">[ASM]</a> &#160;</p></div>\r
@@ -1191,6 +1192,23 @@ value. To that end, the values are 64-bit signed integers.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_again"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_again">Word: AGAIN</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: Compiling: ( -- a )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"AGAIN" is an immediate function word that is used together with\r
+<a href="#p_begin">BEGIN</a> and instead of <a href="#p_end">END</a> to implement structured\r
+execution control. AGAIN scans the datastack for the nearest preceding\r
+BEGIN marker and lays out an unconditional branch from this point the\r
+beginning of the block during execution. It thereafter performs the\r
+<a href="#p_end">END</a> compile action to end the block.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_allot"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
@@ -3411,7 +3429,7 @@ is deepest.</p></div>
 <div id="footer">\r
 <div id="footer-text">\r
 Last updated\r
- 2021-06-03 21:07:44 AEST\r
+ 2021-06-04 18:26:45 AEST\r
 </div>\r
 </div>\r
 </body>\r