str_split_c

	sub_strings.i1p.r = str_split_c(source_string.i1a.r, source_length.i4.v,
					delimiter_str.i1a.r, delimiter_len.i4.v,
					case_sensitive.i4.v, wildcard.i1.v,
					ignore_spaces.i4.v, num_substrings.i4.r
					[,options.u8.v] [,max_splits.i4.v])

	This routine returns the array of substrings making up a larger
	string.  The delimiter between adjacent substrings is determined
	by a passed substring.  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.)
	case_sensitive	case sensitivity flag for the delimiter string
			(TRUE -> case sensitive search,
			 FALSE -> case insensitive search)
	wildcard	wildcard character which will match any
			single character with the delimiter string
			(STR_NO_WILDCARD -> don't use any wildcards,
			 otherwise -> desired wildcard character)
	ignore_spaces	delimiter white space handling flag
			(TRUE -> ignore embedded white spaces,
			 FALSE -> treat white spaces like any other character)
	num_substrings	returned number of substrings found
			(A value of NULL can be passed for this argument
			 if this information is not needed.)
	[options]	split options
			(STR_OPT_NONE -> no options selected,
			 STR_OPT_NO_NULL_STRINGS -> don't return zero length
						    substrings (default),
			 STR_OPT_RETURN_NULL_STRINGS -> return zero length
							substrings if
							encountered)
	[max_splits]	maximum number of split strings to look for
			(default is 0 which results in searching for all splits)

	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_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

	C/C++ usage:

	static const char	source_string[] = "string1\\string2";
	static const char	delimiter_str[] = "\\";
	char	wildcard = STR_NO_WILDCARD;
	char	**sub_strings;
	int	source_length = 0;
	int	delimiter_len = 0;
	int	case_sensitive = FALSE;
	int	ignore_spaces = TRUE;
	int	num_substrings;
	int	max_splits = 0;
	unsigned long long	options = 0;

	sub_strings = str_split_c(source_string,source_length,delimiter_str,
				  delimiter_len,case_sensitive,wildcard,
				  ignore_spaces,&num_substrings,options,
				  max_splits);