ConcatenateVectors()

Summary

Concatenates vectors into one, combined long vector.

 

Changes

Added to Version 2014.

In Version 2021 numeric vectors do not need to be of the same data type.

 

Syntax

new_vec = ConcatenateVectors(array input_vectors)

 

Argument	Contents
vectors	An array of vectors in the order they are to be concatenated

 

Returns

A new vector with a the original vectors concatenated in order.

 

Notes

• If the input vectors are numeric their types do not have to match exactly. The resulting vector will be the more generic of the two types, or in the case of mixing a long and float types, the result will be a double type (to ensure full precision)

• Only the first two vectors are in the input vectors array are concantenated, extra vectors are ignored

• For more information on vectors, see Vectors

Example

a = Vector(2, "real", {{"Constant", 1}})  // a = [1,1]
b = Vector(3, long, {{"Sequence", 3,1}})  // b = [3,4,5]

c = ConcatenateVectors({a,b}) // c = [1,1,3,4,5]

 

Error Codes

Error Type	Meaning
Error	One of the elements in the input vectors array is not a vector or the input vectors array includes numeric and string vecrtors have

See Also

GISDK Function	Summary
ArrayToVector()	Copies an array to a vector
CopyVector()	Copies a vector to a new vector
CumulativeVector()	Constructs a cumulative vector in a new vector
GetDataVector()	Creates a vector from a field in a view|set
GetDataVectors()	Creates vectors from fields in a view|set
SetDataVector()	Fills values into a field in a view|set from a vector
SetDataVectors()	Fills values into fields in a view|set from vectors
SortVector()	Sorts the elements of a vector in ascending order
SortVectors()	Sorts an array of vectors in ascending order, based on the first vector
TransposeArray()	Transposes an array of arrays, where element b[i][j] = a[j][i]
Vector()	Creates a vector
VectorStatistic()	Computes a given statistic for the vector
VectorToArray()	Copies a vector to an array