AuLookupEventHandler(3)

💖 AuLookupEventHandler(3) 💖

okay bestie, this is a page from the Library Functions Manual for AuLookupEventHandler(3) — and yes, we're getting into the audiolib lore. buckle up 🎀

✨ NAME ✨

AuLookupEventHandler — find the next handler for an event. that's it. that's the job. she finds handlers. 🔍

🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

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

like, look at her. three args, one return, zero drama. 💅

🦋 ARGUMENTS 🦋

• server — Specifies the connection to the audio server. your little link to the audio server, your bestie on the other end of the wire 💜
• event — Specifies the event to find a handler for. the event in question, the one we're out here hunting a handler for 👀
• startwith — Specifies the starting position. where in the list you wanna start looking from. (note: the synopsis calls her start, the argument list calls her startwith — same girl, different name tag, no cap 🏷️)

🔥 DESCRIPTION 🔥

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

and if there isn't one? she returns NULL. not me getting ghosted by a function 💀

literally that's it. search from startwith, next handler or NULL. periodt.

💜 SEE ALSO 💜

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

🫶 reminder bestie: the "next handler" thing is load-bearing — she doesn't start from the top of the list, she starts from startwith. that's the whole point of the name.

and that's the page!! this came out of audioutil, version 1.9.4, and this cutie is dated AuLookupEventHandler(3) — mwah, go forth and find your handlers 💖✨🎀