REBOL Document

Append - Function Summary


Appends a value to the tail of a series and returns the series head.


append series value


series - The series argument. (must be: series port)

value - The value argument.


/only - Appends a block value as a block


Works on any type of series, including strings and blocks. Returns the series at its head.

/ONLY forces a block to be inserted as a block element (works only if the first argument is a block).

    string: copy "hello"
    probe append string " there"
    "hello there"

    file: copy %file
    probe append file ".txt"

    url: copy http://
    probe append url ""

    block: copy [1 2 3 4]
    probe append block [5 6]
    [1 2 3 4 5 6]

    probe append/only block [a block]
    [1 2 3 4 5 6 [a block]]


change - Changes a value in a series and returns the series after the change.
insert - Inserts a value into a series and returns the series after the insert.
remove - Removes value(s) from a series and returns after the remove.

<Back | Index | Next>

Copyright 2004 REBOL Technologies