Append - Function Summary

Summary:

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

Usage:

append series value

Arguments:

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

value - The value argument.

Refinements:

/only - Appends a block value as a block

Description:

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"
%file.txt

url: copy http://
probe append url "www.rebol.com"
http://www.rebol.com

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]]

Related:

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.