


XmRegisterSegmentEncoding(3X)			XmRegisterSegmentEncoding(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmRReeggiisstteerrSSeeggmmeennttEEnnccooddiinngg - A	compound string	function that registers	a
  compound text	encoding format	for a specified	font list element tag

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  cchhaarr ** XXmmRReeggiisstteerrSSeeggmmeennttEEnnccooddiinngg ((_f_o_n_t_l_i_s_t__t_a_g, _c_t__e_n_c_o_d_i_n_g))
       cchhaarr   **_f_o_n_t_l_i_s_t__t_a_g;;
       cchhaarr   **_c_t__e_n_c_o_d_i_n_g;;

DESCRIPTION
  XXmmRReeggiisstteerrSSeeggmmeennttEEnnccooddiinngg registers a	compound text encoding format with
  the specified	font list element tag.	The XXmmCCvvttXXmmSSttrriinnggTTooCCTT function uses
  this registry	to map the font	list tags of compound string segments to com-
  pound	text encoding formats.	Registering a font list	tag that already
  exists in the	registry overwrites the	original entry.	 You can unregister a
  font list tag	by passing a NULL value	for the	_c_t__e_n_c_o_d_i_n_g parameter.

  _f_o_n_t_l_i_s_t__t_a_g
	 Specifies the font list element tag to	be registered.	The tag	must
	 be a NULL-terminated ISO8859-1	string.

  _c_t__e_n_c_o_d_i_n_g
	 Specifies the compound	text character set to be used for segments
	 with the font list tag.  The value must be a NULL-terminated
	 ISO8859-1 string.  A value of XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG maps the speci-
	 fied font list	tag to the code	set of the locale.

RETURN VALUE
  Returns NULL for a new font list tag or the old _c_t__e_n_c_o_d_i_n_g value for	an
  already registered font list tag.   The application is responsible for
  freeing the storage associated with the returned data	(if any) by calling
  XXttFFrreeee.

RELATED	INFORMATION
  XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX)), XXmmFFoonnttLLiisstt((33XX)), XXmmMMaappSSeeggmmeennttEEnnccooddiinngg((33XX)), and
  XXmmSSttrriinngg((33XX)).



















