Changeset 450 for branches/thune/thread_safe/doc/UserManual

Timestamp:

08/11/07 04:53:46 (16 months ago)

Author:

krobillard

Message:

Removed slice! datatype - series now have an end.
Added slice test.
ur_makeBinary() now takes pointer argument.
Fixed bug in _makeComponent().
Fixed compiler warnings. Minor optimization to if/.

Files:

• branches/thune/thread_safe/doc/UserManual (modified) (5 diffs)

branches/thune/thread_safe/doc/UserManual

@@ -89 +89 @@
 set-select!  :obj/x :my-block/2
 lit-select!  'obj/x 'my-block/2
-slice!
 time!        10:02 -0:0:32.08
 context!
@@ -125 +124 @@
 
 
+Binary
+------
+
+A binary value references a series of bytes.
+
+::
+
+     #{0000ff01}
+     #{0000 ff01}
+     #{68656C6C6F}     ; "hello" as binary
+
+
 Strings
 -------
@@ -138 +149 @@
    {This string
    spans multiple lines.}
-
-
-Slice
------
-
-A range within a binary!, string!, or block! can be represented with a slice.
-
-::
-
-    "Hello world" :s
-    slice! s make .                  ; "Hello world"
-    slice! s next dup 4 skip make .  ; "ello"
-
-To move the start of the slice use *prev* & *next*, as with a series.
-To move the end of the slice use *slice.prev* & *slice.next*.
 
 
@@ -455 +451 @@
 next        (ser -- ser)            Increment start of series.
 skip        (ser n -- ser)          Increment start of series by **n**.
+slice_      (ser end -- slice)      Slice series.
+slice?      (ser end -- slice)      True if series is a slice.
 slice.prev  (slice -- slice)        Decrement end of slice.
 slice.next  (slice -- slice)        Increment end of slice.
@@ -631 +629 @@
 
 
+slice
+-----
+
+The slice word is used to control the slice range of a series value.
+
+::
+
+    "Hello world" :s
+    s 2,6 slice .          ; "ello"
+    s -2 slice .           ; ""Hello wor"
+
+
+To move the start of a series by one, use *prev* & *next*.
+To move the end of a series by one, use *slice.prev* & *slice.next*.
+
+
 change
 ------