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

# XmRenderTableGetRenditions(3)

A convenience function that matches rendition tags

## NAME

**XmRenderTableGetRenditions** — A convenience function that matches rendition tags

## SYNOPSIS

```
#include <Xm/Xm.h>
XmRendition *XmRenderTableGetRenditions(
XmRenderTable table,
XmStringTag *tags,
Cardinal tag_count);
```

## DESCRIPTION

**XmRenderTableGetRenditions** searches *table* and returns an array of copies of the renditions whose **XmNtag** resources match a tag in *tags*. If no renditions match, then NULL is returned. The size of the returned array is *tag\_count*. The **XmNtag** resource of each rendition will match the corresponding tag in *tags*. If no match is found for a particular tag, the corresponding slot in the return value will be NULL.

It is the responsibility of the caller to call the **XmRenditionFree** function to free the new renditions, and the **XtFree** function to free the array.

- *table*

  Specifies the table containing renditions to be searched.

- *tags*

  Specifies the tags to search for.

- *tag\_count*

  Specifies the number of tags in *tags*.

## RETURN

Returns NULL if there is no match; otherwise, this function returns an array of new **XmRendition**s.

## RELATED

[**XmRenderTableGetRendition**(3)](/XmRenderTableGetRendition/3.md), [**XmRenderTableGetTags**(3)](/XmRenderTableGetTags/3.md), and [**XmRendition**(3)](/XmRendition/3.md).