MAT()

The MAT() function creates an array for insertion into a data collection.

Format

MAT()

MAT(array {, elements})

where

array

is a dimensioned array.

elements

is the maximum number of elements to copy. if omitted or zero, all elements are copied.

The first form of the MAT() function creates an empty array. The second form copies the content of an array variable previously dimensioned using the DIM statement. In both forms, the only valid use of the value returned by this function is to store it in a data collection.

Arrays in data collections are single dimensional. If the array argument is a two dimensional array, elements are copied row by row to form a single dimensional result.

Example

DIM EMAIL.ADDRESSES(10)

...statements that set values in the above array...

CLIENT{'email'} = MAT(EMAIL.ADDRESSES)

The above program fragment copies the values in the EMAIL.ADDRESSES dimensioned array to become an array element named email within the CLIENT data collection.