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

# XmTabListInsertTabs(3)

A convenience function that inserts tabs into a tab list

## NAME

**XmTabListInsertTabs** — A convenience function that inserts tabs into a tab list

## SYNOPSIS

```
#include <Xm/Xm.h>
XmTabList XmTabListInsertTabs(
XmTabList oldlist,
XmTab *tabs,
Cardinal tab_count,
int position);
```

## DESCRIPTION

**XmTabListInsertTabs** creates a new tab list that includes the tabs in *oldlist*. This function copies specified tabs to the tab list at the given position. The first *tab\_count* tabs of the *tabs* array are added to the tab list. If *oldlist* is NULL, **XmTabListInsertTabs** creates a new tab list containing only the tabs specified.

- *oldlist*

  Specifies the tab list to add the tabs to. The function deallocates *oldlist* after extracting the required information.

- *tabs*

  Specifies a pointer to the tabs to be added to the tab list. It is the caller's responsibility to free the tabs in *tabs* by using **XmTabFree**.

- *tab\_count*

  Specifies the number of tabs in *tabs*.

- *position*

  Specifies the position of the first new tab in the tab list. A value of 0 (zero) makes the first new tab the first tab in the tab list, a value of 1 makes it the second tab, and so on. If *position* is greater than the number of tabs in *oldlist*, then the tabs will be inserted at the end. If *position* is negative, the count will be backwards from the end. A value of -1 makes the first new tab the last tab, and so on.

## RETURN

If *tabs* is NULL or *tab\_count* is 0 (zero), this function returns *oldlist*. Otherwise, it returns a new tab list. The function allocates space to hold the returned tab list. The application is responsible for managing the allocated space. The application can recover the allocated space by calling **XmTabListFree**.

## RELATED

[**XmTabList**(3)](/XmTabList/3.md) and [**XmTabListFree**(3)](/XmTabListFree/3.md).