Guardian Procedure Calls Reference Manual

READEDITP Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The READEDITP procedure reads one line from a specified EDIT file and returns it to the caller in
EDIT packed line format.
READEDITP 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(READEDITP)>
short READEDITP ( short filenum
,[ __int32_t *record-number ]
,char *packed-line
,short packed-limit
,short *packed-length );
Syntax for TAL Programmers
error := READEDITP ( filenum ! i
,[ record-number ] ! i,o
,packed-line ! o
,packed-limit ! i
,packed-length ); ! o
Parameters
filenum
input
INT:value
specifies the file number of the open file that is to be read.
record-number
input, output
INT(32):ref:1
if present, specifies the record-number of the line to be read. If record-number:
• is greater than or equal to 0, READEDITP reads the line (if any) with the smallest EDIT line
number that is greater than or equal to the value of 1000 times record-number.
• is -1, READEDITP reads the lowest-numbered line (if any) in the file.
• is -2, READEDITP reads the highest-numbered line (if any) in the file.
• is -3 or omitted, READEDITP reads the line (if any) with the smallest record number that is
greater than or equal to the next record number.
1206 Guardian Procedure Calls (R)