Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-243
FORMATCONVERT[X] Procedure
eformat input
STRING:ref:* (Use with FORMATCONVERT)
STRING .EXT:ref:* (Use with FORMATCONVERTX)
is the format string in external (ASCII) form.
eformatlen input
INT:value
is the length, in bytes, of the
eformat string.
scales output
INT:ref:* (Use with FORMATCONVERT)
INT .EXT:ref:* (Use with FORMATCONVERTX)
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.
scale-count input, output
INT:ref:* (Use with FORMATCONVERT)
INT .EXT:ref:* (Use with FORMATCONVERTX)
on call, is the number of occurrences of the
scales array.
On return,
scale-count contains the actual number of repeatable edit
descriptors converted.
If the number of repeatable edit descriptors present is greater than the number
entered here, FORMATCONVERT[X] stops storing scale factors when the
scale-
count
maximum is reached, but it continues to process the remaining edit
descriptors and it continues incrementing
scale-count.
Note. The scales parameter information is included to provide information needed by the
ENFORM product. It might not interest most users of FORMATCONVERT[X]. If so, supply a
variable initialized to 0 for scales and scale-count.