Guardian Procedure Calls Reference Manual

Parameters
iformat
output
(for FORMATCONVERT)STRING:ref:*
(for FORMATCONVERTX)STRING .EXT:ref:*
is an array in which FORMATCONVERT[X] stores the converted format. The contents of this
array must be passed to the FORMATDATA[X] procedure as an integer parameter, but
FORMATCONVERT requires it to be in byte-addressable G-relative storage. Thus iformat
must be aligned on a word boundary, or the contents of iformat must be moved to a
word-aligned area when it is passed to FORMATDATA[X]. (The area passed to FORMATDATA
need not be in byte-addressable storage.)
iformatlen
input
INT:value
is the length, in bytes, of the iformat array. If the converted format is longer than
iformatlen, the conversion terminates and a status value <= 0 returns.
eformat
input
(for FORMATCONVERT)STRING:ref:*
(for FORMATCONVERTX)STRING .EXT:ref:*
is the format string in external (ASCII) form.
eformatlen
input
INT:value
is the length, in bytes, of the eformat string.
scales
output
(for FORMATCONVERT)INT:ref:*
(for FORMATCONVERTX)INT .EXT:ref:*
is an integer array. FORMATCONVERT[X] processes the format from left to right, placing the
scale factor (the number of digits that appear to the right of the decimal point) specified or
implied by each repeatable edit descriptor into the next available element of scales. This is
done until the last repeatable edit descriptor is converted or the maximum specified by
scale-count is reached, whichever occurs first.
630 Guardian Procedure Calls (F)