Guardian Procedure Calls Reference Manual

Examples
This group of edit descriptors is preceded by a repeat factor that specifies the formatting of ten
data items, each one to be preceded by the label NUMBER. If there are fewer than ten data items
in the data list, formatting terminates immediately after the last value is processed. If the colon is
not present, formatting continues until the I edit descriptor is encountered for the fourth time. This
means the fourth label is added before the formatting is terminated.
These example illustrate this usage:
Data Items:
1
2
3
Format:
Without colonWith colon
10('NUMBER ',I1,/)10('NUMBER ',I1,:/)
Results:
Without colonWith colon
|NUMBER 1||NUMBER 1|
|NUMBER 2||NUMBER 2|
|NUMBER 3||NUMBER 3|
|NUMBER |
The "|" character is used to denote the boundaries of the output field.
Repeatable Edit Descriptors
These descriptions give the form, function, and requirements for each of the edit descriptors that
specify formatting of data fields. These edit descriptors can be preceded by an unsigned integer
repeat factor to specify identical formatting for a number of values in the data list.
These descriptions of the operation of repeatable edit descriptors apply when no decorations or
modifiers are present.
The A Edit Descriptor
The A edit descriptor is used to move characters between the buffer and the data element without
conversion. This is normally used with ASCII data. The A edit descriptor has one of these forms:
AORAw
is an unsigned integer constant that specifies the width, in characters, of the field and must not exceed 255.
The field processed is the next w characters starting at the current position.
w
If w is not present, the field width is equal to the actual number of bytes in the associated data element, but
cannot exceed 255. Values over 255 are reduced to 255.
After the field is processed, the current position is advanced by w characters.
On output, the operation of the A edit descriptor is as follows:
1. The number of characters specified by w, or the number of characters in the data element,
whichever is less, is moved to the external field. The transfer starts at the left character of both
Repeatable Edit Descriptors 1555