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

# XmStringGetLtoR(3)

A compound string function that searches for a text segment in the input compound string

## NAME

**XmStringGetLtoR** — A compound string function that searches for a text segment in the input compound string

## SYNOPSIS

```
#include <Xm/Xm.h>
Boolean XmStringGetLtoR(
XmString string,
XmStringCharSet tag,
char **text);
```

## DESCRIPTION

This function is obsolete and exists for compatibility with previous releases. It is replaced by **XmStringUnparse**. **XmStringGetLtoR** returns the first text component in the input compound string that is tagged with the given tag component. The returned text is to be a NULL-terminated sequence of single byte characters. If the function returns True, the function will allocate space to hold the returned *text*. The application is responsible for managing the allocated space. The application can recover the allocated space by calling **XtFree**.

- *string*

  Specifies the compound string.

- *tag*

  Specifies the font list element tag associated with the text. A value of **XmFONTLIST\_DEFAULT\_TAG** identifies a locale text segment.

- *text*

  Specifies a pointer to a NULL terminated string.

## RETURN

Returns True if the matching text segment can be found. On return, *text* will have a NULL terminated byte sequence containing the matched segment.

## RELATED

[**XmStringCreate**(3)](/XmStringCreate/3.md).