AuNextEvent(3)

💖 AuNextEvent(3) — from the Library Functions Manual, bestie 💖

okay so picture this: you're sitting there with your audio server connection, the event queue is doing its little thing, and you just wanna know what's next. That's literally the whole plot of this page. Welcome to the group chat, we're talking about AuNextEvent 🦋

✨ SYNOPSIS ✨

#include <audio/audiolib.h>

void AuNextEvent(server, dequeue, event)
    AuServer *server;
    AuBool dequeue;
    AuEvent *event; /* RETURN */

🎀 ARGUMENTS 🎀

• server — the connection to the audio server. your lil' link to the homie, yk?
• dequeue — tells it whether the event should get yanked out of the queue or not.
• event — this one returns the event. it's a RETURN situation, she's giving output parameter 💅

🌸 DESCRIPTION 🌸

AuNextEvent copies the next available event into event. that's it, that's the job, no cap 👑

so if dequeue is AuTrue, the event gets removed from the queue — like, gone, she left the building, bye 🚪✨

and if the event queue is empty?? not me waiting around 😭 — AuNextEvent flushes the output queue and then blocks until one arrives. like she will literally just stand there until the event shows up. main character energy fr fr.

heads up bestie: that blocking thing is real. if nothing's coming, you're waiting. that's the vibe, that's the deal 💀

👀 SEE ALSO 👀

• AuEventsQueued
• AuScanEvents
• AuScanForTypedEvent
• audiolib — Network Audio System C Language Interface

and that's the whole page, periodt 💜 this was the audiolib — event handling chapter, version 1.9.5, filed under AuNextEvent(3). ily, go dequeue something 🫶🌈