concatArrays() Operation

anArray.concatArrays(anotherArray_1, ..., anotherArray_n)

Concatenates the elements of one or more arrays to the elements of anArray. All arrays must have the same array element type.

• The arrays to be concatenated cannot be NULL.

• If an array has NULL elements, these will be preserved after concatenation.

anArray, anotherArray

Can be any variable or object attribute having the type Array. The arrays must not be NULL.

Find the related error codes on System Errors.

BESM/2

One of the parameters of a vararg function returned NULL.
This error occurs if one of the arrays is NULL.

Input: an array of customers and an array of prospects

{ "customers": [
    {"company": "Summer Ltd.", "name": "Adam Sun"},
    {"company": "Summer Ltd.", "name": "Barbara Beaches"},
    {"company": "Winter & Partners", "name": "John Snow"}
]}

{ "prospects": [
    {"company": "Spring Corp.", "name": "Rose Bloom"},
    {"company": null, "name": null},
    {"company": "Summer Ltd.", "name": "Cloe Cloud"}
]}

set resultArray = customers.concatArrays(prospects);

A new array resultArray is created containing all references to elements of the listed arrays.

{ "resultArray": [
    {"company": "Summer Ltd.", "name": "Adam Sun"},
    {"company": "Summer Ltd.", "name": "Barbara Beaches"},
    {"company": "Winter & Partners", "name": "John Snow"},
    {"company": "Spring Corp.", "name": "Rose Bloom"},
    {"company": null, "name": null},
    {"company": "Summer Ltd.", "name": "Cloe Cloud"}    
]}

The NULL values of the prospect array are preserved.

Note that the resultArray contains object references to the array elements of customers and prospects. Refer to Object References to get a better understanding of the effects.