UniBasic Commands Reference - Rocket Software

MATREAD
Syntax
MATREAD dim.array [FROM [file.var,]record.ID.expr [ON ERROR statements]
{THEN statements [END] | ELSE statements [END]}
Description
The UniBasic MATREAD command assigns the values found in successive attributes
of a record to corresponding elements of a dimensioned array — regardless of
lock status.
You must use the DIM command to create a dimensioned array before you execute
MATREAD.
Note: This command does not check for locks. If you are operating in a multiuser
environment, you must use record locks to prevent users from overlaying data
updated by others. For more information about the UniBasic record locking, see
Developing UniBasic Applications.
Parameters
The following table describes each parameter of the syntax.
Parameter Description
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.
MATREAD Parameters
MATREAD 1-449