buffer_tosa(3)

🌸 buffer_tosa(3) 🌸

okay bestie, welcome to the Library Functions Manual ✨ this one's a lil libowfat gem and it's lowkey iconic, let's get into it 💅

✨ NAME ✨

buffer_tosa — initialize buffer for writing to stralloc 🎀

💖 SYNTAX 💖

#include <libowfat/buffer.h>

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

🦋 DESCRIPTION 🦋

so basically, buffer_tosa makes a virtual write buffer out of a stralloc. that's it, that's the vibe 💫

the buffer writing functions will just keep appending data to the stralloc, and they'll keep doing that until the stralloc fails to allocate more memory. like, it's giving "we go until we literally can't" 😭

⚠️ bestie, you still need to flush the buffer. don't forget. i'm serious. flush it 🙈

and one more thing, and it's kinda important ngl: in the end, the stralloc is gonna have allocated more memory than is needed to hold the actual contents. the waste is exactly 1024 bytes. so yeah, you're paying a lil memory tax for the convenience 💸✨

👑 RETURN VALUE 👑

• 0 — everything was fine, we ate, no crumbs 🍓
• -1 — it failed to allocate space for the initial data in the stralloc 💀

🌈 SEE ALSO 🌈

• buffer_tosa(3)
• buffer_init(3)
• buffer(3)

mwah 💋 that's the whole page — this is buffer_tosa(3) straight from the Library Functions Manual, and that's the last line of the page too, so consider yourself fully signed off, bestie 🫶 go flush your buffers ✨🎀