str_get_tagged_value_alloc_c

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

	This routine extracts and allocates 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 memory for those strings
	are allocated by this routine and should be freed by the caller.
	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	returned null terminated tag string
			(The memory for this buffer is allocated by this
			 routine and should be freed by the caller.)
	value_string	returned null terminated value string to
			(The memory for this buffer is allocated by this
			 routine and should be freed by the caller.)
	[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_SYNTAX		invalid syntax or tag/value pair not found

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_get_tagged_value_c, str_get_value_c, strtok, str_split_c,
	str_get_bracketed_c

	C/C++ usage:

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

	source_string = source_buffer;

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