Guardian Procedure Calls Reference Manual

GETPOSITIONEDIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Related Programming Manual
Summary
The GETPOSITIONEDIT procedure returns the record number (1000 times the EDIT line number)
of the line in the specified file most recently read or written (that is, it returns the current record
number).
GETPOSITIONEDIT is an IOEdit procedure and can only be used with files that have been opened
by OPENEDIT or OPENEDIT_.
Syntax for C Programmers
#include <cextdecs(GETPOSITIONEDIT)>
__int32_t GETPOSITIONEDIT ( short filenum );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
position := GETPOSITIONEDIT ( filenum ); ! i
Parameters
filenum
input
INT:value
specifies the file number of the open file of interest.
Returned Value
INT(32)
Position in file. Either:
• The current record number (1000 times the EDIT line number) of the specified file.
• -1 if the file is not open or if the file is positioned at its beginning.
• -2 if the last operation was a read end-of-file.
Related Programming Manual
For programming information about the GETPOSITIONEDIT procedure, see the Guardian
Programmer's Guide.
GETPOSITIONEDIT Procedure 665