MAT()

MAT()

Top  Previous  Next

 

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

 

 

Format

 

MAT()

MAT(array {, elements})

 

where

 

arrayis a dimensioned array.

 

elementsis 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.

 

 

See also:

Data collections