status.i4.v = str_trim_c(trimmed_string.i1a.r, string.i1a.r,
				 trim_type.i4.v [,length.i4.v])

	This routine will remove spaces 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_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)
	[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
	CLIB_NO_CHANGE		output string is the same buffer as
				the input string and there were no
				spaces to trim

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_trim_characters_c, str_pad_c, str_justify_c,
	str_insert_terminator_c, str_shift_c, str_find_first_c,

	C/C++ usage:

	static const char	string[] = "   string   ";
	char	trimmed_string[32];
	int	status;
	int	trim_type = STR_TRIM_BOTH;
	int	length = 0;

	status = str_trim_c(trimmed_string,string,trim_type,length);