Guardian Procedure Calls Reference Manual

Note that a subcommand may immediately follow "D" without being preceded by "//."
If a subcommand begins with "R," "I," or "D," it is recognized as an explicit command.
Otherwise, it is recognized as an implied replacement.
The action of the subcommands is as follows:
◦ R (or r) for "replace"
This subcommand replaces characters in data with replacement-string on a
one-for-one basis. Replacement begins with the character corresponding to R. The
replacement-string is terminated by the end of template or by a "//" sequence
in template. Trailing blanks are considered part of the replacement string (that is, blanks
are not ignored).
◦ Implied replacement
A subcommand that does not begin with "R," "I," or "D" is recognized as a
replacement-string. Characters in replacement-string replace the
corresponding characters in data on a one-for-one basis.
◦ D (or d) for "delete"
This subcommand deletes the corresponding character in data.
I (or i) for "insert"
This subcommand inserts a string from template into data preceding the character
corresponding to the "I". The insertion-string is terminated by the end of template
or by a "//" sequence in template. Trailing blanks are considered part of the insertion
string (that is, they are not ignored).
• When data is truncated
The maximum-data-len serves to protect data residing past the end of the data string.
Therefore, data is truncated whenever data-len exceeds maximum-data-len during
processing by FIXSTRING.
In particular, FIXSTRING truncates data if data-len temporarily exceeds
maximum-data-len, even if template contains delete subcommands that result in a data
string of the correct length.
• When insertion string is truncated
If an insertion causes the length of data to exceed maximum-data-len, the FIXSTRING
truncates insertion-string.
• modification-status is equal to 1 if a replacement is performed that leaves data
unchanged.
Example
CALL FIXSTRING ( S^TEMP^ARRAY , TEMP^LEN , SCOMMAND , NUM );
Related Programming Manual
For programming information about the FIXSTRING utility procedure, see the Guardian Programmer's
Guide.
612 Guardian Procedure Calls (F)