MATSTR()

MATSTR()

Top  Previous  Next

 

The MATSTR() function builds a dynamic array from a matrix.

 

 

Format

 

MATSTR(array)

 

where

 

arrayis a dimensioned array.

 

 

The MATSTR() is intended for use with a two dimensional matrix and builds a dynamic array in which each row is represented by a field and the columns are represented by values in the field. Used with a single dimensional matrix, MATSTR() is closely related to the MATBUILD statement and returns a dynamic array with a field for each element of the matrix.

 

For arrays that include the zero element, this is ignored by MATSTR(). Also note that field or value mark characters appearing in the matrix data are not handled in any special way and are therefore likely to lead to ambiguous results.

 

 

Example

 

DIM DATA(100,4)

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

STRING = MATSTR(DATA)

 

The above program fragment sets STRING to be a dynamic array with 100 fields, each divided into 4 values corresponding to the rows and columns of the DATA matrix.

 

 

See also:

MATBUILD