XMTABLISTINSERTTABS(3)

💖 XmTabListInsertTabs 💖

okay bestie, welcome to the XmTabListInsertTabs page, straight out of the Xm library (that's the Motif toolkit, for the uninitiated 👑). It's a library call, it's a convenience function, and it's about to slide some tabs into a tab list like it's adding songs to the aux queue. 🎀

✨ 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 ✨

So here's the vibe: XmTabListInsertTabs creates a brand new tab list that includes the tabs in oldlist. It copies the tabs you specify into the tab list at the given position. Specifically, the first tab_count tabs of the tabs array get added. And if oldlist is NULL? No worries bestie, it just makes a whole new tab list containing only the tabs you specified. 🌈

• oldlist — says which tab list to add the tabs to. Heads up though: the function deallocates oldlist after it extracts the info it needs. So don't go using it after, okay? 💀
• tabs — a pointer to the tabs that are getting added to the tab list. And ngl, it is the caller's responsibility to free the tabs in tabs by using XmTabFree. That's on you, not on the function. 🫶
• tab_count — how many tabs are hanging out in tabs.
• position — where the first new tab lands 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, you get the pattern. If position is greater than the number of tabs in oldlist, then the tabs get inserted at the end. And if position is negative, the count goes backwards from the end — a value of -1 makes the first new tab the last tab, and so on. Backwards counting, it's giving time-travel energy ⏪✨

✨ 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, and the application is responsible for managing that allocated space. To recover it, the application can call XmTabListFree. Don't forget, or that memory is just gonna sit there vibing forever 🙈

✨ RELATED ✨

• XmTabList(3)
• XmTabListFree(3)

and that's the whole page, periodt 💅 This was the Xm library manual — the footer line just reads XmTabListInsertTabs(library call), and it doesn't come with a date stamp, so no timestamp lore today, bestie. Go forth and insert those tabs, iykyk 🌸💜