UniBasic Commands Reference - Rocket Software

Command Meaning
MATREAD
MATREADL
MATREADU
MATPARSE
Examples
In the following example, the program segment fills the array MAIN.MAT with
values from REC. If a sufficient number of elements are available in the target array,
the value of INMAT is set to the number of elements filled. If the number of values
exceeds the number of elements in the target array, excess data is lumped in the 0
position, and the value of INMAT is set to 0.
MATPARSE MAIN.MAT FROM REC, @VM
PRINT INMAT()
In the next example, the program segment dimensions two arrays and then prints the
dimensions using the PRINT statement and INMAT function:
DIM LARGE.ARRAY(23,14)
DIM SMALL.ARRAY(9)
PRINT INMAT(LARGE.ARRAY)
PRINT INMAT(SMALL.ARRAY)
This results in the following:
23}14
9
n – The number of attributes loaded into the array.
0 – More attributes existed in the record than elements existed in the array.
Excess data is stored in the 0,0 element.
OPEN n – The number of modulos in the file.
0 – The file opened is a directory (DIR type).
OSBWRITE n – The number of bytes written to a file or named pipe.
INMAT Function Return Values (continued)
INMAT 1-380