Guardian Procedure Calls Reference Manual

FIXSTRING Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manual
Summary
The FIXSTRING procedure is used to edit a string based on subcommands provided in a template.
Syntax for C Programmers
#include <cextdecs(FIXSTRING)>
_cc_status FIXSTRING ( char *template
,short template-len
,char *data
,short _near *data-len
,[ short maximum-data-len ]
,[ short _near *modification-status ] );
• The function value returned by, which indicates the condition code, can be interpreted by
_status_lt(), _status_eq(), or _status_gt() (defined in the file tal.h).
Syntax for TAL Programmers
CALL FIXSTRING ( template ! i
,template-len ! i
,data ! i,o
,data-len ! i,o
,[ maximum-data-len ] ! i
,[ modification-status ] ); ! o
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").
610 Guardian Procedure Calls (F)