Guardian Procedure Calls Reference Manual

scale-count
input, output
(for FORMATCONVERT)INT:ref:*
(for FORMATCONVERTX)INT .EXT:ref:*
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.
conversion
input
INT:value
Specifies the type of conversion to be done:
Check validity of format only. No data is stored into iformat. The scale information is stored in the
scales array.
0
Produce expanded form with modifiers and decorations. This requires additional storage space, but the
execution time is half that of version 2 (below). The size required is approximately 10 times eformatlen.
1
Produce compact conversion, ignoring modifiers and decorations. The resulting format requires little
storage space, but the execution time is twice as long as version 1 (above).
2
Returned Value
INT
A status value indicating the outcome of FORMATCONVERT[X]:
Successful conversion. The value is the number of bytes in the converted format (iformat).> 0
iformatlen was insufficient to hold the entire converted format.= 0
An error in the format. The value is the negated byte location in the input string at which the error was detected.
The first byte of eformat is numbered 1.
< 0
Related Programming Manual
For programming information about the FORMATCONVERT[X] procedures, see the Guardian
Programmer's Guide.
FORMATCONVERT[X] Procedures 631