


XmCvtXmStringToCT(3X)					XmCvtXmStringToCT(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCCvvttXXmmSSttrriinnggTTooCCTT - A	compound string	function that converts a compound
  string to compound text

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  cchhaarr ** XXmmCCvvttXXmmSSttrriinnggTTooCCTT ((_s_t_r_i_n_g))
       XXmmSSttrriinngg	   _s_t_r_i_n_g;;

DESCRIPTION
  XXmmCCvvttXXmmSSttrriinnggTTooCCTT converts a compound	string to a (char *) string in com-
  pound	text format.  The application must call	XXttAAppppIInniittiiaalliizzee	before cal-
  ling this function.  The converter uses the font list	tag associated with a
  given	compound string	segment	to select a compound text format for that
  segment.  A registry defines a mapping between font list tags	and compound
  text encoding	formats.  The converter	uses the following algorithm for each
  compound string segment:

   11..  If the compound string segment tag is mapped to XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG
       in the registry,	the converter passes the text of the compound string
       segment to XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy with an encoding style of XXCCoomm--
       ppoouunnddTTeexxttSSttyyllee and uses the resulting compound text for that segment.

   22..  If the compound string segment tag is mapped to an MIT registered
       charset in the registry,	the converter creates the compound text	for
       that segment using the charset (from the	registry) and the text of the
       compound	string segment as defined in the X Consortium Standard _C_o_m_-
       _p_o_u_n_d _T_e_x_t _E_n_c_o_d_i_n_g.

   33..  If the compound string segment tag is mapped to a charset in the
       registry	that is	neither	XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG nor an MIT registered
       charset,	the converter creates the compound text	for that segment
       using the charset (from the registry) and the text of the compound
       string segment as an "extended segment" with a variable number of
       octets per character.

   44..  If the compound string segment tag is not mapped	in the registry, the
       result is implementation	dependent.

  _s_t_r_i_n_g Specifies a compound string to	be converted to	compound text.

RETURN VALUE
  Returns a (char *) string in compound	text format.  This format is
  described in the X Consortium	Standard _C_o_m_p_o_u_n_d _T_e_x_t _E_n_c_o_d_i_n_g.

RELATED	INFORMATION
  XXmmCCvvttCCTTTTooXXmmSSttrriinngg((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)),
  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((33XX)), and XXmmSSttrriinngg.








