readclose_append(3)

💖 readclose_append(3) 💖

okay bestie, so this one is from the Library Functions Manual — yes, readclose_append(3), the lil library function that just gets it. sit down, grab a strawberry 🍓, and let's talk about slurping a whole file straight into a stralloc.

✨ NAME ✨

readclose_append — read a whole file into a stralloc 🫶

✨ SYNTAX ✨

#include <libowfat/readclose.h>

ssize_t readclose_append(int fd,stralloc* sa,
                     size_t bufsize);

✨ DESCRIPTION ✨

so here's the tea 🫖: readclose_append reads the whole content into the stralloc sa, and — this is the iconic part — it appends it to whatever's already chillin' in there. it does not wipe what you had. it adds. main character energy, no cap.

the file gets read in chunks of bufsize bytes size. adorable little bites. 🍰

if everything worked fine, readclose_append returns 0. literally the best outcome. slay.

on error, readclose_append returns -1 and sets errno appropriately. 😭 so yeah, if you see that -1, check your errno, bestie — it's telling you exactly what went wrong, iykyk.

💀 real talk: -1 means something broke. don't just ignore it and vibe on. check errno, periodt.

✨ SEE ALSO ✨

• open_read(3)
• openreadclose(3)
• readclose(3)

and that's the whole thing, babe 🎀 go forth and append. this page came to you straight outta the Library Functions Manual, filed under readclose_append(3) — take care of her, she's doing her best 💅💜🦋