AuLookupEventHandler(3)

💖 AuLookupEventHandler — the section 3 girlies know 💖

okay so this one lives in the Library Functions Manual, section 3, and it's genuinely so useful. it's giving "where's the handler for this event" energy, and honestly? we love a little search function. 🦋

---

🌸 NAME 🌸

AuLookupEventHandler — find the next handler for an event.

like literally, that's her whole job. she finds the next handler. she's not doing anything else. iconique. 👑

---

✨ SYNOPSIS ✨

#include <audio/audiolib.h>

AuEventHandlerRec *AuLookupEventHandler(server, event, start)
    AuServer *server;
    AuEvent *event;
    AuEventHandlerRec *start;

no cap, that's the whole thing. three args, one return value, we move. 💅

---

🎀 ARGUMENTS 🎀

• server — Specifies the connection to the audio server. yes bestie, you need to actually be connected to the audio server first, that's the whole vibe. 🔌
• event — Specifies the event to find a handler for. this is the little event in question, the main character of this particular search. 🎯
• startwith — Specifies the starting position. where do we begin looking? right here, babes. that's the launchpad. 🚀

ok tiny detail but I have to say it because I refuse to lie to you: the synopsis calls it start and the argument list calls it startwith. both are in the original, both are staying, I'm not touching them. that's just how she is. 🙈

---

🌈 DESCRIPTION 🌈

AuLookupEventHandler searches the list of registered event handlers, starting with startwith, and returns the next event handler. 🫶

and if there's no next one? she hands you NULL. that's it. that's the whole deal. not 0, not a sad little error code, just NULL. so fr fr, check for that before you go dereferencing anything, or it's over for you. 💀

the way that she just walks the handler list from your starting point and gives you the next one — lowkey elegant, highkey underrated. ✨

---

👀 SEE ALSO 👀

• AuDispatchEvent
• AuRegisterEventHandler
• AuUnregisterEventHandler
• audiolib — Network Audio System C Language Interface

go read those too, they're all in the same friend group, iykyk. 💜

---

kisses, mwah 💋 — this page is from audioutil, version 1.9.5, and yeah, AuLookupEventHandler(3) is the girl's full name, use it with respect. bye bestie, go register some handlers 🎀✨