str_get_first_c

	character.i1.v = str_get_first_c(string.i1a.r, length.i4.v,
					 direction.i4.v, position.i4.r)

	This routine will return the first or last non-blank character
	in a string.  A value of NULL is returned if there are no nonblank
	characters.

	string		string to search
	length		length of string to search (a value of zero
			will result in a search up to a null terminator)
	direction	direction of search
			(STR_FIRST -> get first nonblank character,
			 STR_LAST -> get last nonblank character)
	position	returned character position (starts at 1)
			(A value of NULL can be passed for this argument
			 if this value isn't needed.)

	This function returns status values as follows:

	-1			invalid length or direction passed
	0			non-blank character not found
	otherwise		first non-blank character

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	str_find_first_c, str_starts_with_c, str_nonblank_length_c,
	str_num_nonblank_c, str_is_blank_c, fndfst, str_find_character_c,
	str_find_character_set_c, fndchr(_c), str_find_string_c,
	str_find_last_string_c, strstr,  strstr_nocase,
	str_insert_terminator_c, str_trim_c, str_trim_characters_c,
	str_character_count_c, str_find_not_in_character_set_c

	C/C++ usage:

	char	character;
	static const char	string[] = "   string   ";
	int	length = 0;
	int	direction = STR_FIRST;
	int	position;

	character = str_get_first_c(string,length,direction,&position);