Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)

Guardian Procedure Calls Reference Manual—522629-013

4-104

EDITREADINIT Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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

Syntax for TAL Programmers

Parameters

status returned value

INT

is a value indicating the outcome of EDITREADINIT. Values returned into

status

are:

0 Successful (OK to read)

-1 End of file detected (empty file)

-2 I/O error

#include <cextdecs(EDITREADINIT)>

short EDITREADINIT ( short _near *edit-controlblk

,short filenum

,short bufferlen );

status := EDITREADINIT ( edit-controlblk ! o

,filenum ! i

,bufferlen ); ! i