Guardian Procedure Calls Reference Manual

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, 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.
unpacked-length
output
INT .EXT:ref:1
returns the actual length in bytes of the value returned in unpacked-line. If unpacked-line
is not large enough to contain the value that is the output of the operation, unpacked-length
returns a negative value.
[ reserved parameter ]
is reserved for internal use. When using the parameters that follow, you must supply a
placeholder comma for the reserved parameter.
spacefill
input
INT:value
if present and not equal to 0, specifies that if the value returned in unpacked-line is shorter
than unpacked-limit, READEDIT should fill the unused part of unpacked-line with space
characters. Otherwise, READEDIT does nothing to the unused part of unpacked-line.
full-lengthinput
input
INT:value
if present and not equal to 0, specifies that all trailing space characters (if any) in the line being
processed should be retained in the output line and should be counted in the value returned
in unpacked-length. Otherwise, trailing space characters are discarded and not counted
in unpacked-length.
1204 Guardian Procedure Calls (R)