Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual522629-013
5-221
FIXSTRING Procedure
Parameters
template input
STRING:ref:*
is the character string to be used as a modification template.
There are three basic subcommands that you can use in
template: replacement,
insertion, and deletion.
In addition, replacement can be either explicit (a subcommand beginning with “R”)
or implicit (a subcommand beginning with any nonblank character other than “R,”
“I,” or “D”). The form of
template is:
template = { subcommand // ... }
subcommand =
{ Rreplacement string } ! replace subcommand
{ Iinsertion string } ! insert subcommand
{ D } ! delete subcommand
{ replacement string } ! implicit replacement
template-len input
INT:value
is the length, in bytes, of the template string.
data input, output
STRING:ref:*
on input, is a string to be modified. The resulting string returns in this parameter.
data-len input, output
INT:ref:1
on input, contains the length, in bytes, of the string input in
data. On return, it
contains the length, in bytes, of the modified data string in
data.
maximum-data-len input
INT:value
contains the maximum length, in bytes, to which
data can expand during the call
to FIXSTRING. If omitted, 132 is used for this value.