Changeset 510 for trunk/thune/doc/UserManual

Timestamp:

02/10/08 23:53:46 (9 months ago)

Author:

krobillard

Message:

'loop is now an opcode and can act as loop.to for integers.
File port! read now handles optional limit.
console.out now handles binary!.
Can now 'make an int! from first 4 bytes of a binary!
Added ur_initDecimal macro.
Added 'fcalc.
Removed word inc/dec.

Files:

• trunk/thune/doc/UserManual (modified) (3 diffs)

trunk/thune/doc/UserManual

@@ -364 +364 @@
 either    (logic t-val f-val -- )    Evaluate either t-val or f-val.
 forever   (block -- )                Evaluate block until exception thrown.
+loop_     (block n -- )              Repeat block **n** times.
+loop_     (block n limit -- )        Repeat block **n** to **limit** times.
 iter      (ser body -- )             Iterate over series.
 iter/N    (ser body -- )             Iterate over series with skip.
@@ -393 +395 @@
 each.set  (ser words body -- )       Iterate over series and assign elements.
 while     (body cond -- )            Evaluate body while cond is true.
-loop      (block n -- )              Repeat block **n** times.
 loop.to   (block n limit -- )        Repeat block **n** to **limit** times.
 proc.env  (env body -- proc)         Create procedure with private context.
@@ -632 +633 @@
 
 
+loop
+----
+::
+
+    (block int -- )
+    (block int int -- )
+
+The first form simply evalutes the body block a given number of times.
+
+The second form pushes the counter value onto the stack before each loop,
+and stops when the limit is reached.
+
+Example::
+
+    )> [.] -2 2 loop
+    -2
+    -1
+    0
+    1
+
 
 Data Manipulation Functions