Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-17
READEDIT Procedure
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-length 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.
Example
error := READEDIT (filenumber, record^num, line^image,
line^maxlength, line^actual^length, ,
space^fill);
IF error THEN ... ! handle error
IF line^actual^length < 0 THEN ... ! buffer (line^image)
! too small for return
! value
Related Programming Manual
For programming information about the READEDIT procedure, refer to the Guardian
Programmer’s Guide.