Concat
Concat(A,B,I,J,K)
Concatenates lists or arrays.
When A and B are 1-D arrays,
Concat(A,B)
returns a list (1-D array) consisting of their elements. This form is often used to concatentate two indexes to obtain the elements for a third index.
When A and B are 1-D arrays with a common index
Concat([A],[B])
returns a 2-D array with two columns. Notice square brackets surrounding the variables. If only two parameters are used, column index is .K.
When A and B are arbitrary arrays, where A has index I and B has index J, then
Concat(A,B,I,J,K)
concatenates (i.e., joins) arrays A and B, with the new result indexed by K. You must provide an index K whose length is the sum of the lengths of I and J. Often the index K is obtained using the first form of concatenate.
(new to 4.1) You can omit the K parameter:
Concat(A,B,I,J)
when you do so, the function creates a new local index named K for the result.
When using the five parameter form, Concat(A,B,I,J,K)
, the index element values don't impact the result, so it doesn't matter if the elements of K
are also elements of I
or J
, nor does it matter what order the index elements of K
appear in. All that matters is that the number of elements in K
is the number of elements of I
plus the number of elements in J
. The positional ordering of the slices of each array are not altered -- the result consists of all the elements of A
followed by all the elements of B
.
When A
(or B
) is implicitly indexed (for example, if it is a list or a single number), you can omit the index parameter. For example:
Concat([0],B,,J,K)
would prepend a column of zeroes to B
.
Library
Array functions
Examples
Index In1 := ['a','b','c']
Concat( In1, ['z'] ) &rarry ['a','b','c','z']
index I := [1, 2]; index J := ['a', 'b']; index K := concat(J, 'c'); var A := Array( I, J, 1 ); var B := Array( I, 2 ); Concat( A, [B], J, , K) Result: a b c 1| [1, 1, 2 2| 1, 1, 2]
Enable comment auto-refresher