str_trim_characters_c

	status.i4.v = str_trim_characters_c(trimmed_string.i1a.r, string.i1a.r,
					    trim_chars.i1a.r, trim_type.i4.v
					    [,options.u4.v] [,length.i4.v])

	This routine will remove specified characters from the beginning and
	end of strings.

	trimmed_string	returned null terminated trimmed string
			(Note: This argument may point to the original string.)
	string		string to trim
	trim_chars	null terminated list of characters to be trimmed
	trim_type	type of trim requested
			(STR_TRIM_BEGIN -> remove spaces from the beginning
					   of the string,
			 STR_TRIM_END -> remove spaces from the end of
					 the string,
			 STR_TRIM_BOTH -> remove spaces from the beginning
					  and the end of the string)
	[options]	trim options
			(STR_OPT_NONE -> no options selected (default),
			 STR_OPT_NO_TRIM -> don't trim white space unless
					    they are included in the set
					    of characters to trim,
			 STR_OPT_HANDLE_QUOTES -> stop trimming when a
						  quote character is reached)
	[length]	length of string (If a value of zero is passed,
			the length of the string will be calculated.)
			(default is 0)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid length or trim type
	CLIB_MEMFAIL		dynamic memory allocation failure

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_trim_c, str_pad_c, str_justify_c, str_insert_terminator_c,
	str_shift_c, str_find_first_c, str_get_first_c

	C/C++ usage:

	static const char	string[] = "astringb";
	static const char	trim_chars[] = "ab";
	char	trimmed_string[32];
	int	status;
	int	trim_type = STR_TRIM_BOTH;
	int	length = 0;
	unsigned int	options = STR_OPT_NONE;

	status = str_trim_characters_c(trimmed_string,string,trim_chars,
				       trim_type,options,length);