Syntax |
| ||
---|---|---|---|
Semantics | Concatenates the elements of one or more arrays to the elements of anArray . | ||
Substitutables | anArray | Can be any variable or object attribute having the type Array. The arrays must not be NULL . | |
Error Codes | Find the related error codes on System Errors. | ||
BESM/2 | One of the parameters of a vararg function is null. This error occurs if one of the arrays is | ||
Examples |
anArray is changed to point to the new array. |
The figure below shows an example of concatenating several arrays in a new array and into an array with existing elements.
Figure: concatArray() Example
array2
or array3
) are empty (not NULL
), no exception occurs.NULL
elements (e.g. element1
, element2
, NULL
, element4
), the NULL
elements will be preserved after concatenation.