buffer_fromsa(3)

💖 buffer_fromsa(3) 💖

okay bestie, welcome to the Library Functions Manual, section 3, the one and only buffer_fromsa — and yes she's iconic, she's giving "I turn your stralloc into a reading experience" 🦋

✨ NAME ✨

buffer_fromsa — initialize buffer structure from stralloc

no cap, that's literally the whole job description 💅

🌸 SYNTAX 🌸

#include <libowfat/buffer.h>

void buffer_fromsa(buffer* b,const stralloc* sa);

copy that exactly, don't be out here improvising 🎀

💜 DESCRIPTION 💜

so here's the tea: buffer_fromsa makes a virtual read buffer out of a stralloc. The buffer reading functions will be able to read all the way until the end of the data in the stralloc, and then they signal EOF. periodt, that's where it ends 🌈

and here's the cute part — the buffer does not have its own buffer space. nope. she reuses the one that's already in the stralloc. no duplication, no extra memory, just vibes ✨

⚠️ DO NOT TOUCH THE stralloc UNTIL YOU ARE DONE WITH THE BUFFER!! ⚠️ like, in particular, do not call stralloc_free on it! not even a little! that's the number one way to make your program absolutely lose its mind 😭🙈 consider this your vibe check, bestie

okay and one more thing, because I know you were gonna ask: reading data from the buffer will not change the stralloc. your data stays exactly as it was. she's a reader, not a writer 💖

🫶 SEE ALSO 🫶

• buffer_tosa(3)
• buffer_init(3)
• buffer(3)
• buffer_frombuf(3)
• buffer_fromarray(3)

go read those too, they're the whole friend group 👑

that's the whole page, fr fr. this came to you straight from the Library Functions Manual — buffer_fromsa(3), section 3 — and yeah, she's a keeper 💅💖 stay hydrated, don't free the stralloc, and slay ✨🌸