str_find_tag_c

	status.i4.v = str_find_tag_c(tag_type.i4.v, source_string.i1a.r,
				     source_length.i4.v, options.i4.v,
				     max_return.i4.v, tag_string.i1a.r,
				     is_end_tag.i4.v, next_string.i1p.r)

	This routine finds tag strings within a source string.

	tag_type	type of tag to look for
			(STR_HTML_TAG -> HTML style tag (<[/]string>))
	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.)
	options		option flags
			(STR_OPT_NONE -> no options selected,
			 STR_OPT_HANDLE_QUOTES -> preserve quoted strings,
			 STR_OPT_HANDLE_ESCAPED_QUOTES -> handle escaped quotes,
			 STR_OPT_WANT_END_TAG -> want an end tag)
	max_return	maximum number of tag string characters to return
			(default is 256)
	tag_string	buffer to copy tag string to (It must be long
			enough to hold the tag string plus a null
			terminator.)
	is_end_tag	returned flag indicating whether or not the returned
			tag was an end tag
			(TRUE -> end tag,
			 FALSE -> begin tag)
	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 tag type or source length passed
	CLIB_MEMFAIL		dynamic memory allocation failure
	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_find_string_c, str_find_last_string_c, str_find_character_c,
	str_find_character_set_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[] = "<html>This is a string.</html>";
	char	tag_string[MAX_RETURN+1];
	char	*next_string;
	int	status;
	int	tag_type = STR_HTML_TAG;
	int	source_length = 0;
	int	max_return = MAX_RETURN;
	int	is_end_tag;
	unsigned int	options = STR_OPT_HANDLE_QUOTES;

	status = str_find_tag_c(tag_type,source_string,source_length,options,
				max_return,tag_string,is_end_tag,next_string);