DADiSP Online Help

Click here to see this page in full context

CONCAT

Purpose:

Concatenates any number of series or tables.

Syntax:

CONCAT(series1, series2, ..., seriesN)

Returns:

A table or series whose length is the end-to-end sum of the input lengths.

Example:

W1: {1, 2, 3}

W2: concat(W1, rev(W1))

W2 contains the series {1, 2, 3, 3, 2, 1}

Example:

W1: {{1, 2}, {3, 4}}

W2: {{5, 6}, {7, 8}}

W3: concat(w1, w2)

W4: ravel(w1, w2)

W1 == {{1, 2},

       {3, 4}},

W2 == {{5, 6},

       {7, 8}}

W3 == {{1, 2},

       {3, 4},

       {5, 6},

       {7, 8}}

W4 == {{1, 2, 5, 6},

       {3, 4, 7, 8}}

CONCAT combines multi-column series on a column basis and RAVEL combines multi-column series on a row basis.

Example:

concat(W1, W2, W6, gcos(100, 0.1))

creates a new series by appending the series in Window 1, Window 2 and Window 6, and a generated cosine wave end-to-end.

Example:

concat(W3..W8)

concatenates the series in Windows 3 through 8.

Remarks:

CONCAT concatenates tables on a column-by-column basis.

CONCAT operates on any number of series.

CONCAT operates on both Real and Complex series and returns a complex series if any of the input series are Complex.

See the {} operator to combine scalars and/or series.

See the @= operator or the APPEND function to append one or more series in place.

See RAVEL to combine tables on a row-by-row basis.

concat(a, b) is equivalent to a @@ b.

See Also:

..

{} Array Construction

@= (APPEND)

@@ (CONCAT)

APPEND

EXTRACT

INSERT

MERGE

RAVEL

REPLICATE