buffer_getline_sa(3)

💖 buffer_getline_sa — the manual, but make it make sense

okay bestie, welcome to section 3 of the Library Functions Manual 🎀 this is buffer_getline_sa(3), and yes she's a libowfat girlie ✨

---

🌸 NAME 🌸

buffer_getline_sa — read a line from a buffer. that's it, that's the whole job description 💅

---

✨ SYNTAX ✨

#include <libowfat/stralloc.h>
#include <libowfat/buffer.h>

int buffer_getline_sa(buffer* b,stralloc* sa);

two includes, one function, zero drama 🫶

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie: buffer_getline_sa takes data from b and appends it to sa until it hits a '\n'. note the word appends — she does NOT overwrite the previous content of sa, okay? the old stuff stays. and the new-line itself? also gets appended to sa. iconic behaviour honestly 👑

now for the part where we gotta be real: if reading from the buffer fails, or if allocating memory fails, buffer_getline_sa returns -1 and sets errno appropriately 😭 and at that exact moment, sa may be empty, or it may already contain a partial token. yeah. partial. like it stopped mid-vibe. so watch out for that 💀

---

⭐ RETURN VALUE ⭐

• -1 on error — and she sets errno while she's at it, no cap
• 0 on EOF
• 1 when successful 🎉

three possible outcomes, zero mystery 🌈

---

💜 RATIONALE 💜

why does she append instead of overwriting? because bestie, that's what makes her usable on non-blocking sockets 🔥

those sockets signal error and set errno to EAGAIN, and when that happens you don't panic — you literally just call buffer_getline_sa again later, once select or poll tell you more data is available. main character energy: she waits for her moment and then she comes back 💅✨

---

👑 SEE ALSO 👑

• buffer_get_token_sa(3)
• buffer(3)

go read your sisters, they're just as iconic 🦋

---

no cap: on error, sa might be empty or hold a partial token. plan accordingly, bestie 🙈

---

and that's the whole page!! brought to you by the Library Functions Manual, filed under buffer_getline_sa(3) in section 3 🎀 mwah, go read a buffer, periodt 💖