str_replace_string_c

	status.i4.v = str_replace_string_c(source_string.i1a.r,
					   source_length.i4.v,
					   match_string.i1a.r,
					   match_length.i4.v,
					   case_sensitive.i4.v,
					   wildcard.i1.v,
					   ignore_spaces.i4.v,
					   replace_string.i1a.r,
					   replace_length.i4.v,
					   next_string.i1p.r)

	This routine finds the first occurrence of one string within another
	and replaces it with another string.  If the source string is a
	simple null terminated string, its length will be changed if the
	match string and the replacement string have different lengths.
	As a result, the buffer containing the source string must be long
	enough to contain the resultant string after a replacement has
	taken place.

	source_string	string to be searched and possibly modified
	source_length	length of string to be searched  (If this argument
			has a value of zero, the routine will determine
			the length of the string.)
	match_string	string to be searched for
	match_length	length of string to be searched for  (If this argument
			has a value of zero, the routine will determine
			the length of the string.)
	case_sensitive	case sensitivity flag
			(TRUE -> case sensitive search,
			 FALSE -> case insensitive search)
	wildcard	wildcard character which will match any
			single character
			(STR_NO_WILDCARD -> don't use any wildcards,
			 otherwise -> desired wildcard character)
	ignore_spaces	white space handling flag
			(TRUE -> ignore embedded white spaces,
			 FALSE -> treat white spaces like any other character)
	replace_string	replacement string
	replace_length	length of replacement string  (If this argument
			has a value of zero, the routine will determine
			the length of the string.)
	next_string	address of the next character in the source string
			following the replacement string
			(If a value of NULL is passed for this argument,
			no address will be returned.)

	This function returns status values as follows:

	CLIB_INVARG		invalid argument passed
	0			string not found
	positive number		index of start of replacement string
				(starts at 1)

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_replace_bracketed_c, str_find_string_c, str_find_last_string_c,
	str_replace_char_c, str_replace_char_set_c, str_remove_char_set_c,
	str_find_character_c, str_find_character_set_c, strstr, strstr_nocase,
	str_compare_n_nocase_c, str_compare_nocase, strncmp, strcmp, strncmx,
	str_insert_string_c, str_split_c, str_get_bracketed_c,
	str_find_not_in_character_set_c

	C/C++ usage:

	static char	source_string[65] = "This is a string.";
	static const char	match_string[] = "is";
	static const char	replace_string[] = "was";
	char	wildcard = STR_NO_WILDCARD;
	char	*next_string;
	int	status;
	int	source_length = 0;
	int	match_length = 0;
	int	case_sensitive = FALSE;
	int	ignore_spaces = TRUE;
	int	replace_length = 0;

	status = str_replace_string_c(source_string,source_length,
				      match_string,match_length,
				      case_sensitive,wildcard,ignore_spaces,
				      replace_string,replace_length,
				      &next_string);