[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmCvtCTToXmString

A compound string function that converts compound text to a compound string

Format

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


[ Previous | Next | Contents | Glossary | Home | Search ]