XMTABLISTGETTAB(3)

💖 NAME 💖

XmTabListGetTab — a convenience function that returns a copy of a tab. yes bestie, a copy, not the og tab itself, this matters so much, keep reading 🫶

This one lives in the library call section of the manual, iykyk.

---

✨ SYNOPSIS ✨

#include <Xm/Xm.h>
XmTab XmTabListGetTab(
XmTabList tablist,
Cardinal position);

---

🦋 DESCRIPTION 🦋

Okay so XmTabListGetTab returns a copy of the tab that is located at the specified position in the tab list. That's the whole vibe. 💅

• tablist — specifies the tab list. it's giving "here's the list we're digging through" ✨
• position — specifies the position of the tab to be returned. a value of 0 (zero) returns the first tab in the tab list, a value of 1 returns the second tab, and so on. so like… zero-indexed, bestie, the counting starts at zero, not one, do not come for me 😭

---

🎀 RETURN 🎀

Returns a copy of the tab that is located at the specified position in the tab list.

But wait — plot twist: if position is greater than or equal to the number of tabs in the tab list, this function returns NULL. 💀 no tab for you, that index does not exist.

🚨 Important, fr fr: the application is responsible for managing the space allocated by the returned tab copy. yes YOU, the app, you're the main character here and you own that memory. 🫶

The application can recover this allocated space by calling XmTabFree. clean up after yourself, it's the least you can do 🌸

---

🌸 RELATED 🌸

• XmTabFree(3)
• XmTabList(3)

---

okay that's the whole page, slay, go manage your memory responsibly 👑

This has been XmTabListGetTab, a library call, brought to you by the good people who wrote the manual page — mwah, no cap, it ate. 💖✨🎀🦋