---
name: "XmStringGetNextTriple"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmStringGetNextTriple"
---

# XmStringGetNextTriple(3)

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

## 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)](/XmStringComponentType/3.md) reference page for a list of component types.

## RELATED

[**XmDirection**(3)](/XmDirection/3.md), [**XmString**(3)](/XmString/3.md), [**XmStringComponentType**(3)](/XmStringComponentType/3.md), [**XmStringGetNextComponent**(3)](/XmStringGetNextComponent/3.md), and [**XmStringPeekNextTriple**(3)](/XmStringPeekNextTriple/3.md).