Guardian Procedure Calls Reference Manual

Nonrepeatable Edit Descriptors
These descriptions show the form, function, and requirements for each of the nonrepeatable edit
descriptors.
Tabulation Descriptors
The tabulation descriptors specify the position at which the next character is transmitted to or from
the buffer. This allows portions of a buffer to be processed in an order other than strictly left to
right, and permits processing of the same portion of a buffer more than once.
The forms of the tabulation descriptors are as follows (n is an unsigned integer constant):
nXTRnTLnTn
Indicates that the transmission of the next character to or from a buffer is to occur at the nth character position.
The first character of the buffer is numbered 1.
Tn
Indicates that the transmission of the next character to or from the buffer is to occur n positions to the left of the
current position
TLn
Indicates that the transmission of the next character to or from the buffer is to occur n positions to the right of
the current position
TRn
Is identical to TRnnX
Each of these edit descriptors alters the current position but has no other effect.
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.
Examples
These examples illustrate tabulation descriptors for the following data list values:
100
1000.49F
"HELLO"
ResultsFormat
100 0.1000E+04HELLO
/\ /\ /\ /\
I3,E12.4,A5No tabs
100 0.1000E+04 HELLO
/\ /\ /\ /\
I3,E12.4,1X,A5X
100 0.1000EHELLO
/\ /\ /\ /\
I3,E12.4,TL3,A5TL
100 0.1000E+04 HELLO
/\ /\ /\ /\
I3,E12.4,TR5,A5TR
10HELLO1000E+04
/\ /\ /\ /\
I3,E12.4,T3,A5T
The "/\" marker denotes the boundaries of the output field.
1552 Formatter Edit Descriptors