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


XmStringGetNextTriple

An XmString function that returns the type, length, and value of the next component in the compound string

Format

#include <Xm/Xm.h>
XmStringComponentType XmStringGetNextTriple
XmStringContext
contextunsigned int *lengthXtPointer
*value

DESCRIPTION

XmStringGetNextTriple returns the type, length, and value of the next component in the compound string identified by context. This function returns one component at a time.

context
Specifies the string context structure that was allocated by the XmStringInitContext function.

length
Specifies a pointer to the length of the value of the returned component.

value
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 XtFree.

RETURN

Returns the type of the component found. Refer to the XmStringComponentType (3) reference page for a list of component types.

RELATED

XmDirection (3), XmString (3), XmStringComponentType (3), XmStringGetNextComponent (3), and XmStringPeekNextTriple (3).


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