UniBasic Commands Reference - Rocket Software

INMAT Function Return Values
After you execute MATPARSE, the INMAT function returns one of the values
described in the following table.
Value Description
n The number of elements loaded into the array.
0 The array was too small to contain all elements in the string. All excess data
(including delimiters) is placed in the 0,0 element.
INMAT Function Return Values
Examples
In the following example, the program segment fills the dimensioned array ALPHA
with consecutive characters from a literal string. An empty string is the delimiter,
causing one character to be assigned to each dimensioned array cell. In this case, the
value returned by the INMAT function would be 7.
DIM ALPHA(7)
MATPARSE ALPHA FROM "ABCDEFG",""
The preceding program segment produces the following dimensioned array:
ALPHA(1) = "A"
.
.
.
ALPHA(7) = "G"
In the next example, the program segment dimensions the dimensioned array T and
then fills it with data from a dynamic array. The delimiter specified is the attribute
mark, so each attribute is assigned to consecutive elements of the array. Note that the
string “ITEM” has five elements, but the array is dimensioned with four elements.
After the MATPARSE command, the INMAT function is 0 and the value of the zero
element T(0) is 443.
DIM T(4)
ITEM = "123:@AM:33:@AM:199:@AM:821:@AM:443"
MATPARSE T FROM ITEM, CHAR(254)
MATPARSE 1-447