XmStringGetNextTriple(library call) XmStringGetNextTriple(library call)

NAME

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

SYNOPSIS

#include <Xm/Xm.h>
XmStringComponentType XmStringGetNextTriple(
XmStringContext context,
unsigned int *length,
XtPointer *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).

XmStringGetNextTriple(library call)