appenddataarrays(
ARRAY
,
VALUE
)

The appenddataarrays( function appends two or more data arrays to each other (see Data Arrays).


Parameters

This function has two parameters:

array – the initial array to be modified.

value – value to add to the array (this parameter may be repeated if you want to append multiple values).


Description

This function appends one or more data arrays to create a new combined array. Suppose you have created three data arrays like this:

local primaries,pastels,grays
primaries=dataarray("red","green","blue")
pastels=dataarray("pink","mauve","baby blue")
grays=dataarray("black","white")

You can use appenddataarrays( to combine all of these into a new data array.

local colors
colors = appenddataarays(primaries,pastels,grays)

The end result is an array with eight elements: red, green, blue, pink, mauve, baby blue, black and white.


Error Messages

appenddataarrays( function: Invalid appended data array. – All parameters to this function must be valid data arrays, created with dataarray(, importdataarray(, dataarraybuild(, etc.


See Also


History

VersionStatusNotes
10.0NewNew in this version.