length.i4.v = strlen_xchar(

	This routine returns the length of an XCHAR format character string.

	xchar_string	XCHAR format character string to be copied
			(array of XCHAR structures)

	This function returns status values as follows:

	length of passed string

	This function requires the following include files:

	cns_data_structs_h, cbslib_h

	Related functions:

	strx_length_c, strx_delimited_length_c, strlen, copy_xchar_to_string_c,
	copy_string_to_xchar_c, strx_to_string_and_colors_c, strx_build_c,
	fill_xchar_c, strx_is_blank_c, strx_find_first_c,
	strx_replace_char_set_c, strx_find_character_c

	C/C++ usage:

	int	length;
	static const XCHAR	xchar_string[NUM_CHARS] =
	{{'U', RED}, {'S', WHITE}, {'A', BLUE}, {0, BLACK}, {'X', MAGENTA}};

	length = strlen_xchar(xchar_string);