AuGetElements(3)

💖 AuGetElements(3) 💖

okay bestie, welcome to AuGetElements(3) from the Library Functions Manual — yes it's a real manual page, and yes it's lowkey iconic. this is the one that pulls the elements out of a flow. let's get into it ✨

---

🌸 NAME 🌸

AuGetElements — get the elements in a flow 🎀

---

🦋 SYNOPSIS 🦋

#include <audio/audiolib.h>

AuElement *AuGetElements(server, flow, clocked, num_elements, status)
    AuServer *server;
    AuFlowID flow;
    AuBool *clocked; /* RETURN */
    int *num_elements; /* RETURN */
    AuStatus *status; /* RETURN */

the way this function signature is giving "i hand you back a whole list, no big deal" 💅

---

✨ ARGUMENTS ✨

• server — the connection to the audio server. like, your link to the whole vibe. 🔥
• flow — the ID of the flow you wanna grab the elements from. this is the one you're snooping on, respectfully. 👑
• clocked — returns a boolean value that tells you if the flow is clocked. is it on the clock or not, bestie, that's the question 🕐
• num_elements — returns the number of elements. counting era, fr fr 🔢
• status — if it's non-NULL, it flushes the output buffer and returns the status from the server. so it's not just a return value, it's a whole moment ✨

---

💜 DESCRIPTION 💜

AuGetElements</purl> returns the list of elements that make up flow — or, if there was an error, it returns NULL, with num_elements set to 0. 😭 so no elements, no count, just vibes and an error.

🫶 heads up: use AuFreeElements to free this list when it's no longer needed. do not ghost your memory allocation, bestie. that's not main character energy, that's a leak.

---

💀 ERRORS 💀

• AuBadFlow — the flow said no ❌

---

🌈 SEE ALSO 🌈

• AuSetElements
• audiolib — Network Audio System C Language Interface

---

and that's the whole page, no cap. this lil beauty comes from audiolib - flow elements, version 1.9.5, and its date is AuGetElements(3). periodt. 💅✨🦋