fix terminating NUL on the captured string
[rrq/rrqforth.git] / reference.html
index f49869a4eb7329644a6d974173b691fbe9fb4fd5..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
@@ -832,7 +833,8 @@ asciidoc.install();
 <div class="paragraph"><p><a href="#p_if">IF</a> &#160;\r
 <a href="#p_ifagain">IFAGAIN</a> &#160;\r
 <a href="#p_ifbreak">IFBREAK</a> &#160;\r
-<a href="#p_immediate">IMMEDIATE</a> &#160;</p></div>\r
+<a href="#p_immediate">IMMEDIATE</a> &#160;\r
+<a href="#p_input">INPUT</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_literal">LIT</a> &#160;\r
 <a href="#p_load_file_quote">LOAD-FILE"</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_args">MAIN-ARGS</a> &#160;\r
@@ -1190,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
@@ -2338,6 +2357,19 @@ the most recent word to 1, thereby making that word an immediate word.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_input"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_input">Word: INPUT</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( -- a )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"INPUT" is a variable word for the input stream buffer used by\r
+<a href="#p_evaluate_stream">EVALUATE-STREAM</a>.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_left_bracket"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
@@ -3397,7 +3429,7 @@ is deepest.</p></div>
 <div id="footer">\r
 <div id="footer-text">\r
 Last updated\r
- 2021-06-02 01:27:44 AEST\r
+ 2021-06-04 18:26:45 AEST\r
 </div>\r
 </div>\r
 </body>\r