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

# XmRenderTableRemoveRenditions(3)

A convenience function that removes renditions

## NAME

**XmRenderTableRemoveRenditions** — A convenience function that removes renditions

## SYNOPSIS

```
#include <Xm/Xm.h>
XmRenderTable XmRenderTableRemoveRenditions(
XmRenderTable oldtable,
XmStringTag *tags,
int tag_count);
```

## DESCRIPTION

**XmRenderTableRemoveRenditions** removes from *oldtable* the renditions whose tags match the tags specified in *tags*, then places the remaining renditions in a newly created render table.

- *oldtable*

  Specifies the render table from which renditions are to be removed. This function deallocates the original render table and the matching renditions after extracting the required information.

- *tags*

  Specifies an array of tags, whose corresponding renditions are to be removed from *oldtable*.

- *tag\_count*

  Specifies the number of tags in *tags*.

## RETURN

If *oldtable* or *tags* is NULL, or *tag\_count* is 0 (zero), or no renditions are removed from *oldtable*, this function returns *oldtable*. Otherwise, it returns a newly allocated **XmRenderTable**. The application is responsible for managing this allocated render table. The application can recover this allocated space by calling **XmRenderTableFree**.

## RELATED

[**XmRendition**(3)](/XmRendition/3.md) and [**XmRenderTableFree**(3)](/XmRenderTableFree/3.md).