str_shift_c

	status.i4.v = str_shift_c(string.i1a.r, direction.i4.v,
				  num_shift.i4.v [,length.i4.v])

	This routine will shift characters in a string.

	string		string to shift
	direction	direction to shift
			(STR_SHIFT_LEFT -> left shift,
			 STR_SHIFT_RIGHT -> right shift,
			 STR_SHIFT_LEFT_TRUNCATE -> left shift allowing
						    truncation of nonblank
						    characters,
			 STR_SHIFT_RIGHT_TRUNCATE -> right shift allowing
						     truncation of nonblank
						     characters)
	num_shift	number of character positions to shift
	[length]	length of string to shift (default is for the
			routine to determine the length of the string)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid direction parameter or invalid
				number of character positions to shift

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_justify_c, shift_string_left_c, justfy, str_trim_c,
	str_trim_characters_c

	C/C++ usage:

	static char	string[] = "xxxstring";
	int	status;
	int	direction = STR_SHIFT_LEFT_TRUNCATE;
	int	num_shift = 3;
	int	length = 0;

	status = str_shift_c(string,direction,num_shift,length);