status.i4.v = str_case_c(string.i1a.r, case_type.i4.v, length.i4.v)

	This routine will change the case of the characters in a string.

	string		string to modify
	case_type	type of case conversion
			(STR_UP_CASE_STRING -> make all lower case characters
					       upper case,
			 STR_DOWN_CASE_STRING -> make all upper case
						 characters lower case,
			 STR_INVERT_CASE_STRING -> make all lower case
						   characters upper case and
						   all upper case characters
						   lower case,
			 STR_CAPITALIZE_STRING -> capitalize the first
						  character of each word and
						  make all other characters
						  lower case)
	length		length of string (If a value of zero is passed,
			the length of the string will be calculated.)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid length or conversion type

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	upcase(_c), dncase(_c), toupper, tolower, isupper, islower

	C/C++ usage:

	static char	string[] = "capitalize this string.";
	int	status;
	int	case_type = STR_CAPITALIZE_STRING;
	int	length = 0;

	status = str_case_c(string,case_type,length);