openreadclose(3)

✨ NAME ✨

okay so this is openreadclose(3), straight from the Library Functions Manual, and it's lowkey iconic: it reads a whole file into a stralloc. no cap. 💅

• openreadclose — read a whole file into a stralloc 🎀

🧚 SYNTAX 🧚

       #include <libowfat/openreadclose.h>

       ssize_t openreadclose(const char *filename,
                  stralloc* sa,size_t bufsize);

Include that header, bestie, and you're ready to go. 🫶

💖 DESCRIPTION 💖

openreadclose opens the file filename for reading and reads the whole content into the stralloc sa. It reads the file in chunks of bufsize bytes size. Like, chunk by chunk, but make it fashion. ✨

Here's the return vibe check, fr fr:

• If everything worked fine, openreadclose returns 1. Slay. Periodt. ✅
• If the file did not exist, openreadclose returns 0. Not found, no drama. 🫥
• On every other error, openreadclose returns -1 and sets errno appropriately. It's giving "something went wrong, check errno." 💀

🦋 SEE ALSO 🦋

• open_read(3)
• readclose(3)

That's the whole page, bestie. From the Library Functions Manual, section 3. Bye 💖✨