<!-- $XConsortium: StrGeF.sgm /main/9 1996/09/08 21:05:31 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.MAN430.rsml.1">
<RefMeta>
<RefEntryTitle>XmStringGetNextTriple</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmStringGetNextTriple</Function></RefName>
<RefPurpose>An XmString function that returns the type, length, and value of the next component in the compound string
<IndexTerm>
<Primary>XmStringGetNextTriple</Primary>
</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-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/Xm.h>
</FuncSynopsisInfo>
<FuncDef>XmStringComponentType <Function>XmStringGetNextTriple</Function></FuncDef>
<!--<ParamDef><Replaceable>context, length, value</Replaceable></ParamDef>-->
<ParamDef>XmStringContext <Parameter>context</Parameter></ParamDef>
<ParamDef>unsigned int <Parameter>*length</Parameter></ParamDef>
<ParamDef>XtPointer <Parameter>*value</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmStringGetNextTriple</Function> returns the type, length, and value of the
next component in the compound string identified by <Symbol Role="Variable">context</Symbol>.
This function returns one component at a time.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">context</Symbol></Term>
<ListItem>
<Para>Specifies the string context structure that was allocated by the
<Function>XmStringInitContext</Function> function.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">length</Symbol></Term>
<ListItem>
<Para>Specifies a pointer to the length of the value of the returned component.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">value</Symbol></Term>
<ListItem>
<Para>Specifies a pointer to the value of the returned component.
If the returned value is not NULL, the function allocates space to hold
the returned value.
When the application no longer needs the returned compound string,
the application should call
<Function>XtFree</Function>.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>Returns the type of the component found. Refer to the
&cdeman.XmStringComponentType; reference page for a list of component types.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmDirection;,
&cdeman.XmString;,
&cdeman.XmStringComponentType;,
&cdeman.XmStringGetNextComponent;, and
&cdeman.XmStringPeekNextTriple;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
