It was written:
> > >> help change
> > USAGE:
> >     CHANGE series value /part range /only /dup count
> >
> > DESCRIPTION:
> >      Changes a value in a series and returns the series after the
change.

> For one the docs dont accurately describe what change does.  "Changes a
value in a series and returns the series after the change."  I would say
"Changes a value in a series and returns the part of the series after the
change."

Um, the docs are accurate here. Watch:

>> s: "1234567890"
== "1234567890"
>> r: change s "def"
== "4567890"
>> print head r
def4567890
>> s
== "def4567890"

Note that 's and 'r are the same string.

> Moving onto to change/part, "Limits the amount to change to a given length
or position," is not entirely accurate since its return value indicates that
the whole of the range was changed.  If what it does is not a bug, it would
be somewhat more accurately said "Enforces change limited to a given length
or position."

> > REFINEMENTS:
> >      /part -- Limits the amount to change to a given length or position.
> >          range -- (Type: number series port)

>> s: "1234567890"
== "1234567890"
>> r: change/part s "defghi" 2
== "34567890"
>> print head r
defghi34567890
>> print s
defghi34567890

Note that positions 1 and 2 in s have been replaced with the string
"defghi". A length of "2" from the start of the string.

>> s: "1234567890"
== "1234567890"
>> r: change s "defghi"
== "7890"
>> print head r
defghi7890
>> print s
defghi7890

Note that the first six characters of the string have been replaced.

Andrew Martin
ICQ: 26227169 http://members.nbci.com/AndrewMartin/
-><-


-- 
To unsubscribe from this list, please send an email to
[EMAIL PROTECTED] with "unsubscribe" in the 
subject, without the quotes.

Reply via email to