str_regexp_split_c

	sub_strings.i1p.r = str_regexp_split_c(source_string.i1a.r,
					       source_length.i4.v,
					       delimiter_str.i1a.r,
					       delimiter_len.i4.v,
					       options.u8.v,
					       num_substrings.i4.r)

	This routine returns the array of substrings making up a larger
	string.  The delimiter between adjacent substrings is determined
	by a passed substring.  This delimiter string can contain a
	regular expression.  This routine allocates the memory for the
	array of substrings.  This memory is freed on the next call to this
	routine in which a string is successfully split.  In spite of this,
	you can still use a substring extracted by this call as the input
	string to the next call to this routine.

	source_string	string to be split
	source_length	length of string to be split  (If this argument
			has a value of zero, the routine will determine
			the length of the string.)
	delimiter_str	delimiter string
	delimiter_len	length of delimiter string  (If this argument
			has a value of zero, the routine will determine
			the length of the string.)
	options		search options
			(STR_OPT_NONE -> no options selected,
			 STR_OPT_CASE_SENSITIVE -> treat delimiter string as
						   case sensitive,
			 STR_OPT_USE_EXTENDED_REGEXP -> use extended regular
							expressions,
			 STR_OPT_TREAT_NL_AS_SPECIAL -> treat new lines as
							special characters,
			 STR_OPT_NO_NULL_STRINGS -> don't return zero length
						    substrings (default),
			 STR_OPT_RETURN_NULL_STRINGS -> return zero length
							substrings if
							encountered)
	num_substrings	returned number of substrings found
			(A value of NULL can be passed for this argument
			 if this information is not needed.)

	This function returns values as follows:

	NULL			delimiter string not found
	otherwise		array of pointers to substrings

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_split_c, str_split_by_char_set_c, str_split_by_char_set_nonstatic_c,
	str_find_string_c, str_find_last_string_c, strstr, strstr_nocase,
	str_compare_n_nocase_c, str_compare_nocase, strncmp, strcmp, strncmx,
	str_concatenate_c, str_regexp_insert_string_c,
	str_regexp_remove_string_c

	C/C++ usage:

	static const char	source_string[] = "string1\\string2";
	static const char	delimiter_str[] = "\\";
	char	**sub_strings;
	int	source_length = 0;
	int	delimiter_len = 0;
	int	num_substrings;
	unsigned long long	options = STR_OPT_NONE;

	sub_strings = str_regexp_split_c(source_string,source_length,
					 delimiter_str,delimiter_len,options,
					 &num_substrings);