msginsread
This command reads the next message from fileId
, an open file handle. It then inserts the data into msgId
at offset
of
zero, or offset, if specified.
msginsread ?-stats statsVar? len10 msgId fileId ?offset?
msginsread ?-stats statsVar? nl msgId fileId ?offset?
msginsread ?-stats statsVar? raw msgId fileId len ?offset?
- If a
len10
ornl
read is specified, then the appropriate message boundary is used to terminate the read. - Supply a read length,
len
, for raw reads.
If a statsVar
variable name is supplied, then
the variable is set to contain a list of two values: todo
done
.
-
todo
is the number of bytes requested. This is the length implied by alen10
record header: 0 fornl
reads, or thelen
value for raw reads. -
done
is the actual number of characters read.
These values are useful if a read fails.
This command returns the number of bytes read.