UniBasic Commands Reference - Rocket Software

Parameter Description
INMAT Function Return Values
After you execute MATREAD, the INMAT function returns one of the values
described in the following table.
Note: BASICTYPEs P and R do not support the 0,0 element. If more attributes are
read from the file than can be placed in the dimensioned array, a runtime error results
and data is lost.
Examples
In the following example, the program segment reads the record with ID NAMES
from the CUSTFILE, and assigns the elements to the dimensioned array TEST. If the
program does not find the record, it assigns the value 0 to the variable FOUND.
1-450 UniBasic Commands Reference
ON ERROR statements Specifies statements to execute if the MATREAD statement fails
with a fatal error because the file is not open, an I/O error occurs,
or UniData cannot find the file.
If you do not specify the ON ERROR clause and a fatal error
occurs, the program terminates.
THEN statements END THEN executes if the read is successful. END is required to
terminate multiline THEN statements.
ELSE statements END ELSE executes if the read is not successful or the record (or ID)
does not exist. END is required to terminate multiline ELSE
statements.
Value Meaning
MATREAD Parameters (continued)
n The number of attributes loaded into the array.
0 The array was too small to contain all attributes in the record. The excess data
(including delimiters) is placed in the 0,0 element.
INMAT Function Return Values
DIM TEST(10,10)
MATREAD TEST FROM CUSTFILE,"NAMES" ELSE FOUND = 0