AuNextEvent(3)

💖 AuNextEvent(3) 💖

Library Functions Manual ✨ the audiolib girlies ✨

okay bestie, welcome to the manual page for AuNextEvent — it's from the audiolib crew (that's the Network Audio System C Language Interface, iykyk), and it does exactly one job and does it slay: it hands you the next event. periodt. 🎀

🌸 Name 🌸

AuNextEvent — return the next event 👑

✨ Synopsis ✨

#include <audio/audiolib.h>

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

no cap, that's the whole signature. three arguments, zero drama. 💅

🦋 Arguments 🦋

• server — the connection to the audio server. your link to the mothership, fr fr. 🌈
• dequeue — tells it whether the event should be removed from the queue or not. yes/no energy. ✨
• event — returns the event. it's the RETURN one, so this is where the good stuff lands. 🎁

💜 Description 💜

so here's the tea, bestie: AuNextEvent copies the next available event into event. like, it goes and grabs it and puts it right there for you. 🫶

if dequeue is AuTrue, the event gets removed from the queue. gone. deleted. it served its purpose and it's moving on. 💀

and if the event queue is empty? not me just sitting here waiting... 👀 lowkey that's literally what it does — AuNextEvent flushes the output queue and then blocks until one arrives. so yeah, it will simply wait. patient queen behavior. 👑

⚠️ heads up: because of that blocking thing, if nothing ever arrives, you're just... there. vibes only. no event, no return. plan accordingly. 🙈

⭐ See Also ⭐

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

go read those next, they're giving the same main character energy fr. 🌟

audiolib — event handling 🎧 · version 1.9.4 · dated with the AuNextEvent(3) era 💖

mwah, that's the page. go forth and dequeue, bestie. 🧚✨🍓