HELP
An object that outputs the concatenation of
all its input data into an Array 1D.

USE
Use Concatenator to combine two or more data
elements into the elements of an Array 1D.
The size of the resultant array is the sum of
the sizes of the inputs.  Data inputs can be
added to allow three or more containers to be
concatenated.

Enum inputs are converted to type Text
before concatenation occurs.

LOCATION
Data ==> Concatenator

NOTES
The output data type is the highest type of
all the input data types.  If any input is an
array of more than one dimension, the array
is flattened (row major) into an Array 1D for
the concatenation.

To concatenate multiple lines of Text into
one line, use Accumulator.

Nil inputs are ignored.  This is different
than the concat(x,y) function which operates
within the formula box.  In the formula box,
all nil inputs are automatically converted to
Real scalars with value 0.  Thus,
concat(a,b), where a is nil and b is an Int32
scalar value 5, results in the Array 1D, two
long of Real with values [0 5].  The
Concatenator object with two inputs with nil
and an Int32 scalar value 5 outputs an Int32
array one long with value [5].

If the first value (first data input) is
mapped, the other input values may be either
mapped with the same point spacing,
or unmapped.  The result will be mapped from
the Xmin to Xmin + dx * N where "Xmin" is the
minimum value of the mapping of the first
array value, "dx" is the distance between two
consecutive points in the first value, and
"N" is the size of the result array.

SEE ALSO
Accumulator, Alloc Array, Collector, Set
Values, and Sliding Collector.

concat(x,y) under Formula.
