XmStringGetNextTriple(3X)



     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 1/22/99)
Museum
