Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-11
READ^FILE Procedure
READ^FILE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Example
Related Programming Manual
Summary
The READ^FILE procedure is used to read a file sequentially. The file must be open
with read or read/write access.
READ^FILE is a sequential I/O (SIO) procedure and should be used only with files that
have been opened by OPEN^FILE.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
error returned value
INT
returns a file-system or SIO procedure error indicating the outcome of the read.
If abort-on-error mode is in effect, the only possible values for
error are:
0 No error
1 End of file
#include <cextdecs(READ_FILE )>
short READ_FILE ( short _near *file-fcb
,short _near *buffer
,[ short _near *count-returned ]
,[ short prompt-count ]
,[ short max-read-count ]
,[ short nowait ] );
error := READ^FILE ( file-fcb ! i
,buffer ! o
,[ count-returned ] ! o
,[ prompt-count ] ! i
,[ max-read-count ] ! i
,[ nowait ] ); ! i