NAME

       XmCvtCTToXmString  —  A compound string function that converts compound text to a compound
       string "XmCvtCTToXmString" "compound string functions" "XmCvtCTToXmString"

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmCvtCTToXmString(
       char * text);

DESCRIPTION

       XmCvtCTToXmString converts a (char *) string in compound text format to a compound string.
       The  application  must  call  XtAppInitialize before calling this function.  Conversion of
       compound text to compound strings is implementation dependent.

       text      Specifies a string in compound text format to be converted to a compound string.

RETURN

       Returns a compound string derived from the compound text.  The function allocates space to
       hold  the  returned  compound  string.   The  application  is responsible for managing the
       allocated space.  The application can recover the allocated space by calling XmStringFree.
       The  compound  text  is  assumed to be NULL-terminated; NULLs within the compound text are
       handled correctly.  The handling of HORIZONTAL TABULATION (HT) control  characters  within
       the compound text is undefined.  The compound text format is described in the X Consortium
       Standard Compound Text Encoding.

RELATED

       XmCvtXmStringToCT(3).

                                                                             XmCvtCTToXmString(3)