Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-19
READEDITP Procedure
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.
record-number returns the value of the file’s new current record number after
the read has been performed. This is equal to the record number of the line that
was read, or it is -2 (end of file) if no line was read.
packed-line output
STRING .EXT:ref:*
is a string array that contains the line in unpacked format that is the outcome of the
operation. The length of the unpacked line is returned in the
packed-length
parameter.
packed-limit input
INT:value
specifies the length in bytes of the string variable
packed-line.
packed-length output
INT .EXT:ref:1
returns the actual length in bytes of the value returned in
packed-line. If
packed-line is not large enough to contain the value that is the output of the
operation,
packed-length returns a negative value.