SoCallbackList(3)

💖 SoCallbackList(3) 💖

okay bestie, gather round, because today we're talking about SoCallbackList from the Library Functions Manual — yes, that SoCallbackList(3), the one and only. it's a container for callback function pointers, and honestly? it's giving ✨personal assistant for your function pointers✨.

---

🌸 NAME 🌸

SoCallbackList — a container for callback function pointers. that's it, that's the whole job, and she does it flawlessly 💅

---

🎀 SYNOPSIS 🎀

#include <Inventor/lists/SoCallbackList.h>

✨ Public Member Functions ✨

SoCallbackList (void)
~SoCallbackList ()
void addCallback (SoCallbackListCB *f, void *userData=NULL)
void removeCallback (SoCallbackListCB *f, void *userdata=NULL)
void clearCallbacks (void)
int getNumCallbacks (void) const
void invokeCallbacks (void *callbackdata)

look at that lineup. iconic. no notes. 👑

---

🦋 Detailed Description 🦋

so SoCallbackList is a container for callback function pointers. periodt.

here's the tea: this list stores callback function pointers — and like, along with the user-specified extra data you wanna pass to those callbacks — and then it gives you a method for triggering the callback functions. it's a whole group chat where you can @everyone on demand. 🔥

---

💜 Constructor & Destructor Documentation 💜

🌈 SoCallbackList::SoCallbackList (void )

Default constructor. she's born. welcome to the world, little list 🎀

🌈 SoCallbackList::~SoCallbackList (void )

Destructor. she's leaving. say bye 🫶

---

👑 Member Function Documentation 👑

⭐ void SoCallbackList::addCallback (SoCallbackListCB * f, void * userdata = NULL)

Append the callback function f to the list. and when it gets invoked? it gets handed the userdata. so like, f shows up to the party and userdata is their plus-one. bestie behavior. 💖

⭐ void SoCallbackList::removeCallback (SoCallbackListCB * f, void * userdata = NULL)

Remove callback f from the list. bye girl, we love you, hope you thrive elsewhere 💅

ngl she's not doing this alone — she references getNumCallbacks(), and SoDebugError::post().

⭐ void SoCallbackList::clearCallbacks (void )

Remove all callbacks in the list. like, everyone. the whole group chat, gone. no survivors. 💀 (affectionately)

⭐ int SoCallbackList::getNumCallbacks (void ) const

Returns number of callback functions. the headcount. the census. the "how many of us are in here" check 📋

she's referenced by removeCallback() — so like, removeCallback() is lowkey stalking her. iykyk.

⭐ void SoCallbackList::invokeCallbacks (void * callbackdata)

Invoke all callback functions, passing the userdata and the callbackdata as the first and second argument, respectively. so first arg = userdata, second arg = callbackdata. in that order. no cap. 🗣️

and here's the important part, so listen up: all callbacks registered when the method is invoked will be triggered — even though if the code in one callback removes another callback. yeah. the call list is locked in at the moment of invocation. once you're on the guest list, you're getting in, even if somebody shreds the guest list mid-party. 🎉

It is safe for a callback to remove itself or any other callbacks during execution. so go ahead, self-destruct, remove your friends, it's fine, the code won't yell at you. that's genuinely so considerate of her fr fr 🥹

she references SbPList::getLength(). shoutout to the underclassman doing the actual counting. 🌟

---

💖 Author 💖

Generated automatically by Doxygen for Coin from the source code. yeah, a robot wrote this, and it ate. 🤖✨

---

okay that's the whole page bestie, go forth and register your callbacks responsibly 💅🌸

signing off — this was Coin, Version 2.5.0, on the SoCallbackList(3) page, and yes the manpage name is literally in the footer too, we're consistent like that 🎀🫶