UniBasic Commands Reference - Rocket Software

READ
Syntax
READ dyn.array.var FROM [file.var,] record.ID.expr [ON ERROR statements]
{THEN statements [END] | ELSE statements [END]}
Description
The UniBasic READ command reads a record from a file and assigns its contents to
a dynamic array. UniData assigns the first attribute of the record to the first position
of the array, the second attribute to the second position, and so on. If UniData cannot
find the record you specify, it executes the ELSE clause and returns dyn.array.var
empty.
Note: This command does not check for locks. If you are operating in a multiuser
environment, you must use record locks to prevent more than one user from accessing
the same record at the same time. For more information about UniBasic record
locking, see Developing UniBasic Applications.
Warning: Do not use UniBasic READ commands to open or modify binary data in
DIR-type files (for example, BP). Doing so could corrupt data in the file. Instead, use
OSREAD or OSBREAD after executing the UniBasic NOCONVERT command.
1-596 UniBasic Commands Reference