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

# XmStringPutRendition(3)

A convenience function that places renditions around strings

## NAME

**XmStringPutRendition** — A convenience function that places renditions around strings

## SYNOPSIS

```
#include <Xm/Xm.h>
XmString XmStringPutRendition(
XmString string,
XmStringTag rendition);
```

## DESCRIPTION

**XmStringPutRendition** places matching **Xm\_STRING\_COMPONENT\_RENDITION\_BEGIN** and **XmSTRING\_COMPONENT\_RENDITION\_END** components containing *rendition* around *string*. The original string is preserved.

- *string*

  Specifies the compound string to which begin and end rendition components should be added.

- *rendition*

  Specifies the rendition tag to be used in an **XmSTRING\_COMPONENT\_RENDITION\_BEGIN** component which will begin the returned string and in an **XmSTRING\_COMPONENT\_RENDITION\_END** component which will end it.

## RETURN

Returns a new compound string. The function allocates space to hold this returned compound string. When the application no longer needs the returned compound string, the application should call **XmStringFree**.

## RELATED

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