SOCALLBACKLIST(3iv)

💖 SoCallbackList — no cap, it's the callback list queen 💖

okay bestie, welcome to the SoCallbackList(3IV) page — yes that's the manual name, we're fancy like that 🎀

🌸 NAME 🌸

SoCallbackList — manages a list of callback functions and associated data ✨

🧬 INHERITS FROM 🧬

SoCallbackList

like, it inherits from itself, which is very main character of it 💅

✨ SYNOPSIS ✨

#include <Inventor/misc/SoCallbackList.h>

typedef void        SoCallbackListCB(void *userData, void *callbackData)

Methods from class SoCallbackList:

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

🦋 DESCRIPTION 🦋

So this class is literally the group chat admin of callback functions 📋 — it manages a whole list of callback functions and user data together.

Here's the vibe: you (the user) can add a callback function to the list, and you bring your own userData along with it. Then when that callback gets invoked, it gets handed your userData — plus some callback data that the invoking routine itself specified. And the type of that callback data? Not SoCallbackList's problem, bestie — that's determined by the invoking routine. iykyk 🫶

💅 METHODS 💅

• SoCallbackList()
• ~SoCallbackList()

Constructor and destructor. Birth and farewell, iconic behavior 🌈

• void addCallback(SoCallbackListCB *f, void *userData = NULL)
• void removeCallback(SoCallbackListCB *f, void *userData = NULL)

Adds a function to — or removes a function from — the list of callback functions. In and out, no drama, periodt ✨

• void clearCallbacks()

Clears all callback functions from the list. Everything. Gone. Poof 💀

• int getNumCallbacks() const

Returns the number of callback functions in the list. A little headcount, a little roll call 🎀

• void invokeCallbacks(void *callbackData)

Invokes each callback function in the list, passing each function the userData supplied when they were registered here, and callbackData, the callback-specific data supplied by the caller. Everybody gets called, everybody gets their data, it's giving democracy 🔥

ngl bestie, if you add a callback and forget to remove it, that's on you — the list does not forget 🙈

and that's the whole page, bestie!! 💖 written up in the SoCallbackList(3IV)() manual, source SoCallbackList(3IV)() — same title, no date drama, we keep it timeless ⭐ mwah, go slay your callbacks 👑