str_regexp_remove_string_c

	status.i4.v = str_regexp_remove_string_c(source_string.i1a.r,
						 match_pattern.i1a.r,
						 [,options.u4.v]
						 [,next_string.i1p.r])

	This routine removes a string matching a regular expression
	from an input string.

	source_string	address of pointer to input string (This will be
			modified if the pattern is matched.)
	match_pattern	null terminated pattern to be searched for
			(If a value of NULL is passed for this argument,
			 the last pattern established will be used.)
	[options]	search options
			(STR_OPT_NONE -> no options selected (default),
			 STR_OPT_CASE_SENSITIVE -> case sensitive operation,
			 STR_OPT_USE_EXTENDED_REGEXP -> use extended regular
							expressions,
			 STR_OPT_TREAT_NL_AS_SPECIAL -> treat new lines as
							special characters in
							conjunction with '^' and
							'$' search characters)
	[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
	CLIB_NOINIT		no search pattern esablished
	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_remove_string_c, str_regexp_find_string_c,
	str_regexp_compile_pattern_c, str_regexp_free_pattern,
	str_regexp_insert_string_c, str_regexp_compare,
	str_regexp_compare_nocase, str_find_string_c,
	str_find_last_string_c

	C/C++ usage:

	static char	source_string[] = "This is a string.";
	static const char	match_string[] = "is.*a";
	char	*next_string;
	int	status;
	unsigned int	options = STR_OPT_NONE;

	status = str_regexp_remove_string_c(source_string,match_string,
					    options,&next_string);