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. | |
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
If the arrays to be concatenated (here array2
or array3
) are empty or NULL
, no exception occurs.
If an array has NULL
elements (e.g. element1
, element2
, NULL
, element4
), the NULL
elements will be preserved after concatenation.