str_insert_char_c

status.i4.v = str_insert_char_c(string.i1a.r, length.i4.v,
insert_position.i4.v, insert_char.i1.v)
This routine inserts a character in the middle of a string.
string string to have character inserted into it
(Note: This buffer must be long enough to hold
the present string plus the additional character.)
length length of "string" (If a value of zero is passed,
the length of the string will be calculated.)
insert_position position in string to insert the character
(starts at 1)
insert_char character to insert into string
This function returns ACNET status values as follows:
OK success
CBS_INVARG invalid length or insert position
This function requires the following include files:
cbslib_h
Related functions:
str_insert_string_c, str_delete_char_c
C/C++ usage:
static char source_string[64] = "string";
char insert_char = 'x';
int status;
int length = 0;
int insert_position = 1;
status = str_insert_char_c(source_string,length,insert_position,
insert_char);