Guardian Procedure Calls Reference Manual (G06.25+)

Formatter Edit Descriptors

Guardian Procedure Calls Reference Manual—522629-013

F-6

Scale-Factor Descriptor (P)

In a quoted literal form, if the character string to be represented contains the same

character that is used as the delimiter, two consecutive characters are used to

distinguish the data character from the delimiter; for example:

In the Hollerith constant form, the number of characters in the string (including blanks)

must be exactly equal to the number preceding the letter H. There are no delimiter

characters, so the characters are supplied exactly as they should appear in the buffer;

for example:

Scale-Factor Descriptor (P)

The form of a scale-factor descriptor is:

n = optionally signed integer in the range of -128 to 127.

The value of the scale factor is zero at the beginning of execution of the

FORMATDATA procedure. Any scale-factor specification remains in effect until a

subsequent scale specification is processed. The scale factor applies to the D, E, F,

and G edit descriptors, affecting them in the following manner:

1. On input, with D, E, F, and G edit descriptors (provided no exponent exists in the

external field), the scale-factor effect is that the externally represented number

equals the internally represented number multiplied by 10**

2. On input, with D, E, F, and G edit descriptors, the scale factor has no effect if there

is an exponent in the external field.

3. On output, with D and E edit descriptors, the mantissa of the quantity to be

produced is multiplied by 10**

n, and the exponent is reduced by n.

4. On output, with the F edit descriptor, the scale-factor effect is that the externally

represented number equals the internally represented number multiplied by 10**

5. On output, with the G edit descriptor, the effect of the scale factor is suspended

unless the magnitude of the data to be processed is outside the range that permits

the use of an F edit descriptor. If the use of the E edit descriptor is required, the

scale factor has the same effect as with the E output processing.

To represent: Use:

can't 'can''t' or "can't"

"can't" '"can''t"' or """can't"""

To represent: Use:

can't 5Hcan't