<!-- $XConsortium: CvtCTTXm.sgm /main/8 1996/08/31 15:21:07 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN190.rsml.1">
<RefMeta>
<RefEntryTitle>XmCvtCTToXmString</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmCvtCTToXmString</Function></RefName>
<RefPurpose>A compound string function that converts compound text to a compound string
<IndexTerm>
<Primary>XmCvtCTToXmString</Primary>
</IndexTerm><IndexTerm>
<Primary>compound string functions</Primary>
<Secondary>XmCvtCTToXmString</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/Xm.h>
</FuncSynopsisInfo>
<FuncDef>XmString <Function>XmCvtCTToXmString</Function></FuncDef>
<!--<ParamDef><Replaceable>text</Replaceable></ParamDef>-->
<ParamDef>char <Parameter>* text</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmCvtCTToXmString</Function> converts a (<StructName Role="typedef">char *</StructName>) string in compound text
format to a compound string.
The application must call <Function>XtAppInitialize</Function> before calling this
function.
Conversion of compound text to compound strings is implementation
dependent.
</Para>
<VariableList>
<VarListEntry>
<Term><Emphasis>text</Emphasis></Term>
<ListItem>
<Para>Specifies a string in compound text format to be converted to a compound
string.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>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 <Function>XmStringFree</Function>.
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
<Emphasis>Compound Text Encoding</Emphasis>.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmCvtXmStringToCT;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
