buffer_getnewline_sa(3)

💖 buffer_getnewline_sa(3) 💖

okay bestie, so this one lives in the Library Functions Manual and it's called buffer_getnewline_sa — say it with me, it's giving "grab me a line, queen". 🎀

✨ NAME ✨

buffer_getnewline_sa — read line from buffer

🌸 SYNTAX 🌸

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

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

🦋 DESCRIPTION 🦋

so what this icon actually does: buffer_getnewline_sa copies data from b over into sa, and it keeps going until it finds a '\n'. and here's the thing — it overwrites whatever was chilling in sa before, so don't get attached to the old contents, they're gone, periodt. 💅 and yes, that newline character itself also gets appended to sa. she comes with the line, she is part of the line. no cap.

if reading from the buffer fails, or if allocating memory fails, buffer_getnewline_sa returns -1 and sets errno appropriately. and at that point? sa may be empty, or it may already contain a partial token. so like, it's a vibe check that failed halfway through. 😭

ok important side note bestie — if you're trying to read from a non-blocking socket, use buffer_getline_sa instead. this one is not the girl for that job. 🙈

👑 RETURN VALUE 👑

• -1 — on error (and she sets errno, she's thorough 💀)
• 0 — on EOF
• 1 — when successful 🎉

🌈 SEE ALSO 🌈

• buffer_get_token_sa(3)
• buffer(3)

and that's the whole page, bestie!! mwah 💜 this was buffer_getnewline_sa(3) from the Library Functions Manual — go read a line, slay, and remember: overwriting is forever. 🫶✨💖