Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-16
READEDIT Procedure
if present, specifies the record number of the line to be read. If record-number:
•
is greater than or equal to 0, READEDIT 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, READEDIT reads the lowest-numbered line (if any) in the file.
•
is -2, READEDIT reads the highest-numbered line (if any) in the file.
•
is -3 or omitted, READEDIT 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.
unpacked-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
unpacked-length
parameter.
unpacked-limit input
INT:value
specifies the length in bytes of the string variable
unpacked-line.