Guardian Procedure Calls Reference Manual (G06.25+)
Formatter Edit Descriptors
Guardian Procedure Calls Reference Manual—522629-013
F-14
The F Edit Descriptor
The “|” character is used to denote the boundaries of the output field.
The following examples illustrate input:
The “|” character is used to denote the boundaries of the output field.
The F Edit Descriptor
The fixed-format edit descriptor is used to display or interpret data in fixed point form.
The F edit descriptor has the following forms:
F
w.d OR Fw.d.m
w an unsigned integer constant that defines the total field width and cannot
exceed 255. The field processed is the
w characters starting at the current
position. After the field is processed, the current position is advanced by
w
characters.
d an unsigned integer constant that defines the number of digits that are to
appear to the right of the decimal point in the external field.
m an unsigned integer constant that defines the number of digits that must be
present to the left of the decimal point on output.
On input, the F
w.d edit descriptor is the same as the Ew.d edit descriptor.
The output field consists of blanks if necessary, followed by a minus if the internal
value is negative or an optional plus otherwise. This is followed by a string of digits
that contains a decimal point and represents the magnitude of the internal value, as
modified by the established scale factor and rounded to the d fractional digits. If the
magnitude of the value in the output field is less than one, there are no leading zeros
except for an optional zero immediately to the left of the decimal point. The optional
zero must appear if there would otherwise be no digits in the output field. If the F
w.d.m
Note. To use the E edit descriptor for output, floating-point firmware is required.
External Field Format Data Element Value
| 0.100E+03| E12.3 100
| 100.05 | E12.5 100.05
| 12345| E12.3 12.345