DADiSP Worksheet Functions > A - E > @= (APPEND)

 

@= (APPEND)

Purpose:

Appends a series onto an existing series.

Syntax:

series1 @= series2

series1

-

A series, the destination series to append onto.

series2

-

A series. The series to append to the destination series.

Returns:

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

Example:

a = {1, 2, 3}

b = {10, 11, 12}

a @= b

 

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

Example:

a = {1, 2, 3}

b = {10, 11, 12}

a @= 10*b

 

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

Remarks:

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

 

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

 

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

See Also:

@@ (CONCAT)

APPEND

CONCAT