Guardian Procedure Calls Reference Manual

READ^FILE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
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
#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 ] );
Syntax for TAL Programmers
error := READ^FILE ( file-fcb ! i
,buffer ! o
,[ count-returned ] ! o
,[ prompt-count ] ! i
,[ max-read-count ] ! i
,[ nowait ] ); ! i
Parameters
file-fcb
input
INT:ref:*
identifies the file to be read.
buffer
output
INT:ref:*
is where the data is returned. The buffer must be located within ‘G'[ 0:32767 ] process data
area.
1200 Guardian Procedure Calls (R)