Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-27
UNPACKEDIT Procedure
packed-length input
INT:value
specifies the length in bytes of
packed-line. The packed-length must be in
the range 1 through 256.
unpacked-line output
STRING .EXT:ref:*
is a string array that contains the line in unpacked format that is the outcome of the
conversion. 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 outcome of
the conversion,
unpacked-length returns a value of -1.
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, UNPACKEDIT should fill the unused part
of
unpacked-line with space characters. Otherwise, UNPACKEDIT 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.
Consideration
If it contains many blank characters, it is possible that the unpacked line might require
much more memory than the packed line. To provide for this, you should specify a
value for
unpacked-limit that is at least fifteen times the value of than packed-
length.