UniBasic Commands Reference - Rocket Software

MATREADL
Syntax
MATREADL dim.array FROM [file.var,]record.ID.expr [ON ERROR statements]
[LOCKED statements] {THEN statements [END] | ELSE statements [END]}
MATREADL dim.array FROM [file.var,]record.ID.expr [LOCKED statements]
[ON ERROR statements] {THEN statements [END] | ELSE statements [END]}
Description
The UniBasic MATREADL command assigns the values found in successive attributes
of a record to corresponding elements of a dimensioned array. MATREADL
checks for locks and will not read a record locked with an exclusive (U) lock. If the
record is available, MATREADL reads and sets a shared (L) lock on it.
Note: UniBasic locks are advisory only. They prevent access by other lock-checking
commands only. For more information about UniBasic locks, see Developing
UniBasic Applications.
Parameters
The following table describes each parameter of the syntax.
Parameter Description
1-452 UniBasic Commands Reference
dim.array Specifies the dimensioned array into which the values are read.
FROM file.var, Specifies the file from which to read.
If you do not specify a file.var, UniData reads from the default
file. If no default file is open, a fatal READ error occurs.
A default file is one for which no file variable is assigned in the
OPEN statement.
record.ID.expr Specifies the record from which to read the attributes.
MATREADL Parameters