str_remove_string_c

	status.i4.v = str_remove_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]
					  [,fill_char.i1.v]
					  [,next_string.i1p.r])

	This routine removes the first occurrence of one string within
	another.

	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.)
			(default is 0)
	[case_sensitive] case sensitivity flag
			(TRUE -> case sensitive search,
			 FALSE -> case insensitive search (default))
	[wildcard]	wildcard character which will match any
			single character
			(STR_NO_WILDCARD -> don't use any wildcards (default),
			 otherwise -> desired wildcard character)
	[ignore_spaces]	white space handling flag
			(TRUE -> ignore embedded white spaces,
			 FALSE -> treat white spaces like any other character
				  (default))
	[fill_char]	fill character (default is 0)
	[next_string]	address of the next character in the source string
			following the removed string
			(If a value of NULL is passed for this argument,
			no address will be returned.)
			(default is NULL)

	This function returns status values as follows:

	CLIB_INVARG		invalid argument passed
	0			string not found
	positive number		index of where string was removed
				(starts at 1)

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_regexp_remove_string_c, str_find_string_c, str_find_last_string_c,
	str_replace_string_c, str_replace_bracketed_c, str_replace_char_c,
	str_replace_char_set_c, str_remove_char_set_c, str_regexp_find_string_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";
	char	wildcard = STR_NO_WILDCARD;
	char	fill_char = 0;
	char	*next_string;
	int	status;
	int	source_length = 0;
	int	match_length = 0;
	int	case_sensitive = FALSE;
	int	ignore_spaces = TRUE;

	status = str_remove_string_c(source_string,source_length,
				     match_string,match_length,
				     case_sensitive,wildcard,ignore_spaces,
				     fill_char,&next_string);