XMLISTREPLACEITEMSUNSELECTED(3)

💖 XmListReplaceItemsUnselected 💖

okay bestie, gather round, because this one is from the (library call) corner of the manual and it's lowkey iconic 🫶

✨ NAME ✨

XmListReplaceItemsUnselected — a List function that swaps items out in a list, no cap 💅

🌸 SYNOPSIS 🌸

#include <Xm/List.h>
void XmListReplaceItemsUnselected(
Widget widget,
XmString *old_items,
int item_count,
XmString *new_items);

🦋 DESCRIPTION 🦋

so like, XmListReplaceItemsUnselected takes each item you point at and replaces it with a matching new item. and here's the main character detail: the replacement items stay unselected — even if they're literally sitting in the XmNselectedItems list right now. yeah. they're unselected. periodt. 🎀

• widget — the ID of the List widget you're doing the replacing in. the one and only. 👑
• old_items — a pointer to the list items that are getting replaced. the ones saying bye 👋
• item_count — how many elements are chillin' in old_items and new_items. and bestie, this number must be nonnegative. negative is not the vibe, don't do it. ⚠️
• new_items — a pointer to the replacement items. here's the lore: every occurrence of each element of old_items gets replaced with the corresponding element from new_items. matching in order, fr fr — first element of old_items ↔ first element of new_items, second ↔ second, and so on until item_count is reached. and if an element in old_items doesn't exist in the list at all? then its matching entry in new_items just gets skipped. nothing happens. it's giving ghosted 😭

for the complete definition of List and all its associated resources, go peek at XmList(3). 📖

🌈 RELATED 🌈

• XmList(3).

and that's the whole page, bestie — a (library call) moment through and through, and yeah the footer is literally just the same title again like a little echo XmListRepla...sUnselected(library call) 💀 stay unselected, stay iconic ✨💖