XmCvtCTToXmString(3X)

     NAME
          XmCvtCTToXmString - A compound string function that converts
          compound text to a compound string

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

     VERSION
          This page documents Motif 2.1.

     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).