APPEND

Purpose:

Appends a series onto an existing series.

APPEND(series, series1, series2, …, seriesN)

series	-	A series, the destination series to append onto.
seriesN	-	One or more series. The series to append to the destination series.

Nothing, one or more series are appended to the destination series in place.

a = {1, 2, 3}

b = {10, 11, 12}

append(a, b)

Series a contains the values {1, 2, 3, 10, 11, 12}.

a = {1, 2, 3}

b = {10, 11, 12}

append(a, b, 10*b)

Series a contains the values {1, 2, 3, 10, 11, 12, 100, 110, 120}.

Because APPEND appends the series to the destination in place, a result is not returned. See CONCAT to return a series.

APPEND is much faster than CONCAT for large series because APPEND operates on the existing series whereas CONCAT creates and assigns a new series.

append(a, b) is equivalent to a @= b.