pSOSystem System Calls - Read

pHILE+ System Calls read_f
read_f Reads from a file.
#include
unsigned long read_f(
unsigned long fid, /* file identifier */
void *buffer, /* input buffer */
unsigned long bcount, /* byte read count */
unsigned long *tcount /* read count status */
)
Volume Types
Description
Arguments
Return Value
All volume types.
read_f() reads data from a file, beginning at the current position of the
connection's L_ptr.
After read_f(), the file's L_ptr is updated to point to the byte after the last byte
that was read.
fid Specifies the file identifier associated with the file.
buffer Points to the memory area to receive the data.
bcount Specifies the number of bytes to read.
tcount Points to the variable where read_f() stores the number of
bytes actually read. The tcount value equals bcount unless the
end-of-file was reached or an error occurred.
This system call returns 0 on success or an error code on failure.
pSOSystem System Calls 2-93
2