str_regexp_find_string_c

	status.i4.v = str_regexp_find_string_c(source_string.i1a.r,
					       source_length.i4.v,
					       match_pattern.i1a.r
					       [,match_length.i4.v]
					       [,case_sensitive.i4.v]
					       [,use_extended.i4.v]
					       [,normal_nl.i4.v]
					       [,options.u4.v]
					       [,next_string.i1p.r])

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

	source_string	string to be searched
	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_pattern	pattern to be searched for  (If a value of NULL is
			passed for this argument, the last pattern established
			will be used.)
	match_length	length of search pattern string  (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))
	use_extended	use extended regular expressions flag
			(TRUE -> use extended regular expressions,
			 FALSE -> don't use extended regular expressions
				  (default))
	normal_nl	new line character handling flag
			(TRUE -> treat new line as a normal characer (default),
			 FALSE -> treat new line characters specially in
				  conjunction with '^' and '$'
				  search characters)
	options		search options (not used) (default is 0)
	next_string	address of the next character in the source 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
	CLIB_MEMFAIL		dynamic memory allocation failure
	CLIB_NOINIT		no search pattern esablished
	0			string not found
	positive number		index of string found (starts at 1)

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_regexp_compile_pattern_c, str_regexp_free_pattern,
	str_find_string_c, str_find_last_string_c, str_find_character_c,
	str_find_character_set_c, str_regexp_compare, str_regexp_compare_nocase,
	str_regexp_replace_string_c, str_regexp_insert_string_c,
	str_regexp_remove_string_c, str_replace_string_c,
	str_replace_bracketed_c, str_replace_char_c,
	str_replace_char_set_c, strstr, strstr_nocase, str_compare_n_nocase_c,
	str_compare_nocase, strncmp, strcmp, strncmx, str_split_c,
	str_get_bracketed_c, str_character_count_c,
	str_find_not_in_character_set_c

	C/C++ usage:

	static const char	source_string[] = "This is a string.";
	static const char	match_pattern[] = "This.*string";
	char	*next_string;
	int	status;
	int	source_length = 0;
	int	match_length = 0;
	int	case_sensitive = FALSE;
	int	use_extended = FALSE;
	int	normal_nl = TRUE;
	unsigned int	options = 0;

	status = str_regexp_find_string_c(source_string,source_length,
					  match_pattern,match_length,
					  case_sensitive,use_extended,
					  normal_nl,options,&next_string);