str_regexp_compile_pattern_c

	status.i4.v = str_regexp_compile_pattern_c(match_pattern.i1a.r
						   [,match_length.i4.v]
						   [,case_sensitive.i4.v]
						   [,use_extended.i4.v]
						   [,normal_nl.i4.v])

	This routine compiles a regular expression pattern for use by
	future search routines.

	match_pattern	pattern to be searched for
	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 character (default),
			 FALSE -> treat new line characters specially in
				  conjunction with '^' and '$'
				  search characters)

	This function returns status values as follows:

	OK			success
	CLIB_INVARG		invalid argument passed
	CLIB_MEMFAIL		dynamic memory allocation failure

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_regexp_free_pattern, str_regexp_find_string_c,
	str_regexp_replace_string_c, str_regexp_compare,
	str_regexp_compare_nocase, str_regexp_insert_string_c,
	str_regexp_remove_string_c

	C/C++ usage:

	static const char	match_pattern[] = "This.*string";
	int	status;
	int	match_length = 0;
	int	case_sensitive = FALSE;
	int	use_extended = FALSE;
	int	normal_nl = TRUE;

	status = str_regexp_compile_pattern_c(match_pattern,match_length,
					      case_sensitive,use_extended,
					      normal_nl);