str_get_tagged_value_c

	status.i4.v = str_get_tagged_value_c(source_string.i1p.r,
					     tag_string.i1a.r,
					     value_string.i1a.r,
					     max_return.i4.v [,options.u4.v]
					     [,separators.i1a.r])

	This routine extracts a tag and value string pair from an
	input string and copies it into caller-supplied output
	strings.  The pointer to the input string is then updated to
	point immediately following the extracted strings.  The output
	strings are always null terminated.  The tag and value pairs
	should have the format "{tag}={value}".  Adjacent tag and value
	pairs can either be separated by white space or commas.  Value
	strings must be enclosed in single or double quotes if they
	contain white space or any of the separators.

	source_string	address of pointer to input string (This will be
			modified to point just past the extracted strings
			upon return.)
	tag_string	buffer to copy extracted tag string to (It must be
			long enough to hold the extracted tag string plus a
			null terminator.)
	value_string	buffer to copy extracted value string to (It must be
			long enough to hold the extracted value string plus a
			null terminator.)
	max_return	maximum number of characters to return not including
			the null terminator
	[options]	option flags
			(STR_OPT_NONE -> no options selected (default),
			 STR_OPT_TRIM -> trim white space from the
					 value string (default),
			 STR_OPT_NO_TRIM -> don't trim white space from the
					    value string,
			 STR_OPT_HANDLE_QUOTES -> preserve quoted value
						  strings,
			 STR_OPT_PRESERVE_QUOTES -> preserve the quote
						    characters in quoted
						    strings,
			 STR_OPT_HANDLE_PARENTHESES -> preserve parenthetical
						       strings,
			 STR_OPT_HANDLE_BRACES -> handle brace enclosed strings,
			 STR_OPT_IGNORE_EXTRA_LINK_CHARS -> ignore extra '='
							    characters in the
							    value_string)
	[separators]	null terminated array of separator characters to be
			used in place of the default separator (comma)
			(Note: Any white space character will always
			 act as a separator.)
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success - tag/value pair extracted
	CBS_INVARG		invalid number of characters
	CBS_SYNTAX		invalid syntax or tag/value pair not found
	CBS_TRUNCATED		one or both strings were truncated

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_get_tagged_value_alloc_c, str_get_value_c, strtok, str_split_c,
	str_get_bracketed_c

	C/C++ usage:

	static const char	source_buffer[] = "tag = value";
	char	tag_string[65];
	char	value_string[65];
	char	*source_string;
	char	*separators = (char *) NULL;
	int	status;
	int	max_return = sizeof(tag_string) - 1;
	unsigned int	options = STR_OPT_NONE;

	source_string = source_buffer;

	status = str_get_tagged_value_c(&source_string,tag_string,value_string,
					max_return,options,separators);