Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-223
FIXSTRING Procedure
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, refer to the
Guardian Programmer’s Guide.