strx_find_character_c

	position.i4.v = strx_find_character_c(xchar_string.sa.r, character.i1.v,
					      length.i4.v, direction.i4.v)

	This routine will return the position of the first or last
	occurrence of a specific character in an XCHAR format string.
	A value of FALSE is returned if the character is not found.

	xchar_string	string to search (array of XCHAR structures)
	character	character to find
	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 -> find first matching character,
			 STR_LAST -> find last matching character)

	This function returns status values as follows:

	CBS_INVARG		invalid length or direction or
				null pointer passed
	FALSE			character not found
	otherwise		position of character (starting at 1)

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	strx_find_first_c, strx_replace_char_set_c, strx_length_c,
	strx_delimited_length_c, strx_is_blank_c, str_find_character_c,
	str_find_character_set_c, strx_to_string_and_colors_c, strx_build_c,
	strx_copy_from_string_c, strx_copy_to_string_c, strx_fill_c,
	strx_fill_color_c

	C/C++ usage:

	char	character = 'r';
	int	position;
	int	length = 0;
	int	direction = STR_FIRST;
	static XCHAR	xchar_string[7] =
	{{'s', WHITE}, {'t', WHITE}, {'r', WHITE}, {'i', WHITE},
	{'n', WHITE}, {'g', WHITE}, {0, BLACK}};

	position = strx_find_character_c(xchar_string,character,length,
					 direction);