copy_string_to_xchar_c

	copy_string_to_xchar_c(xchar_string.sa.r, string.i1a.r, num_chars.i4.v
			       [,color.i4.v])

	This routine copies an ASCII character string into an XCHAR format
	character string.

	xchar_string	output XCHAR format character string
			(array of XCHAR structures)
	string		ASCII string to be copied
	num_chars	number of characters to copy (If a value of
			zero is passed, the length of "string" will be
			calculated and used.)
	[color]		character color (constants are in 'cnsparam')
			(default is to not fill the color values)

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h

	Related functions:

	copy_xchar_to_string_c, strx_build_c, strx_to_string_and_colors_c,
	fill_xchar_c, strlen_xchar, strx_length_c, strx_is_blank_c,
	strx_find_first_c, strx_find_character_c, strx_length_c,
	strx_delimited_length_c

	C/C++ usage:

	static const char	string[] = "string";
	int	num_chars = NUM_CHARS;
	int	color = WHITE;
	XCHAR	xchar_string[NUM_CHARS];

	copy_string_to_xchar_c(xchar_string,string,num_chars,color);