Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WBRIDGE and version 7.6.0
Syntax
Code Block
languagenone
anArray.concatArrays(anotherArray_1, ..., anotherArray_n)
SemanticsConcatenates the elements of one or more arrays to the elements of anArray.
SubstitutablesanArrayCan be any variable or object attribute having the type Array.  The arrays must not be NULL.
Error CodesFind 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 NULL.

Examples
Code Block
languagenone
set anArray = anArray.concatArrays(anotherArray);
A new array is created containing all references to elements of the listed arrays. The reference anArray is changed to point to the new array.

...

Figure: concatArray() Example

  • If the arrays to be concatenated (here array2 or array3) are empty

...

  • (not NULL ), no exception occurs.
  • If an array has NULL elements (e.g. element1, element2, NULL, element4), the NULL elements will be preserved after concatenation.