Guardian Procedure Calls Reference Manual

EDITREADINIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Summary
The EDITREADINIT procedure is called to prepare a buffer in the application program's data area
for subsequent calls to EDITREAD.
The application program designates an array to be used as an edit control block. The edit control
block is used by the EDITREAD procedure for storing control information and as an internal buffer
area.
The EDIT file can be opened nowait. However, a subsequent call to EDITREADINIT completes
before returning to the application; it is not completed with a call to AWAITIO.
Syntax for C Programmers
#include <cextdecs(EDITREADINIT)>
short EDITREADINIT ( short _near *edit-controlblk
,short filenum
,short bufferlen );
Syntax for TAL Programmers
status := EDITREADINIT ( edit-controlblk ! o
,filenum ! i
,bufferlen ); ! i
Parameters
edit-controlblk
output
INT:ref:*
is an uninitialized array that is declared globally. Forty words of the edit control block are
used for control information. The remainder is used as an internal buffer by EDITREAD. The
length, in words, of the edit control block must be at least 40 plus bufferlen divided by 2.
This is the same array as specified in the edit-controlblk parameter to EDITREAD. You
should not modify the contents of edit-controlblk.
filenum
input
INT:value
is the number of an open file that identifies the text file to be read.
338 Guardian Procedure Calls (D-E)