str_starts_with_char_type_c

	status.i4.v = str_starts_with_char_type_c(string.i1a.r, length.i4.v,
						  char_type.i4.v,
						  direction.i4.v,
						  options.u4.v)

	This routine determines whether or not a string starts (or ends)
	with a given type of character.  Leading (or trailing) blanks will
	be ignored unless "char_type" has a value of STR_CHAR_TYPE_WHITE_SPACE
	or the option, STR_OPT_ALLOW_WHITE_SPACE, is selected.

	string		string to check
	length		length of string to check (a value of zero
			will result in a search up to a null terminator)
	char_type	character type to check for
			(STR_CHAR_TYPE_ALPHANUMERIC -> alphanumeric character,
			 STR_CHAR_TYPE_ALPHABETIC -> alphabetic character,
			 STR_CHAR_TYPE_UPPER_CASE -> upper case alphabetic
						     character,
			 STR_CHAR_TYPE_LOWER_CASE -> lower case alphabetic
						     character,
			 STR_CHAR_TYPE_DECIMAL -> decimal character,
			 STR_CHAR_TYPE_HEX -> hexadecimal character,
			 STR_CHAR_TYPE_BINARY -> binary character,
			 STR_CHAR_TYPE_OCTAL -> octal character,
			 STR_CHAR_TYPE_QUOTE -> quote character,
			 STR_CHAR_TYPE_PARENTHESIS -> parenthesis character,
			 STR_CHAR_TYPE_BRACE -> brace character,
			 STR_CHAR_TYPE_WHITE_SPACE -> white space character,
			 STR_CHAR_TYPE_PUNCTUATION -> punctuation character,
			 STR_CHAR_TYPE_PRINTABLE -> printable character,
			 STR_CHAR_TYPE_CONTROL -> control character,
			 STR_CHAR_TYPE_COMPARATOR -> comparator character)
	direction	direction of search
			(STR_FIRST -> compare beginning of string,
			 STR_LAST -> compare end of string)
	options		compare options
			(STR_OPT_NONE -> no options selected,
			 STR_OPT_ALLOW_WHITE_SPACE -> honor embedded white
						      space characters)

	This function returns status values as follows:

	CBS_INVARG		invalid length, character type, or
				direction passed
	TRUE			character matches the requested type
	FALSE			character does not match the requested type

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_starts_with_c, character_type_c, str_find_first_c, str_get_first_c,
	str_nonblank_length_c, str_num_nonblank_c, str_is_blank_c, fndfst,
	str_find_character_c, str_find_character_set_c,
	str_find_not_in_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

	C/C++ usage:

	static const char	string[] = "  string   ";
	int	status;
	int	length = 0;
	int	char_type = STR_CHAR_TYPE_ALPHABETIC;
	int	direction = STR_FIRST;
	unsigned int	options = STR_OPT_NONE;

	status = str_starts_with_char_type_c(string,length,char_type,direction,
					     options);