Guardian Procedure Calls Reference Manual (G06.25+)

Formatter Edit Descriptors
Guardian Procedure Calls Reference Manual522629-013
F-5
Literal Descriptors
The current position can be moved beyond the limits of the current buffer (that is,
become less than or equal to zero, or greater than
bufferlen) without an error
resulting, provided that no attempt is made by a subsequent edit descriptor to transmit
data to or from a position outside the current buffer. Tab descriptors cannot be used to
advance to later buffers or to return to previous ones. The following examples illustrate
tabulation descriptors:
Data List Values
100
1000.49F
"HELLO"
Format Results
No tabs I3,E12.4,A5 100 0.1000E+04HELLO
/\ /\ /\ /\
X I3,E12.4,1X,A5 100 0.1000E+04 HELLO
/\ /\ /\ /\
TL I3,E12.4,TL3,A5 100 0.1000EHELLO
/\ /\ /\ /\
TR I3,E12.4,TR5,A5 100 0.1000E+04 HELLO
/\ /\ /\ /\
T I3,E12.4,T3,A5 10HELLO1000E+04
/\ /\ /\ /\
The “/\” marker denotes the boundaries of the output field.
Literal Descriptors
Literal descriptors are alphanumeric strings in either form:
dc c c ... c d OR nHc c c ... c
1 2 3 n 1 2 3 n
d either an apostrophe (') or a quotation mark ("); the same character must be
used for both the opening and closing delimiters.
c any ASCII character.
n an unsigned nonzero integer constant specifying the number of characters in
the string; n cannot exceed 255.
On input, a literal descriptor is treated as
nX.
A literal edit descriptor causes the specified character string to be inserted in the
current buffer beginning at the current position. It advances the current position
n
characters.