XmStringGetNextTriple(3X) UNIX System V XmStringGetNextTriple(3X)
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);
VERSION
This page documents Motif 2.1.
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).
Page 1 (printed 7/20/06)