iob_addbuf_free(3)

💖 iob_addbuf_free — bestie edition ✨

okay so real talk, this one lives in the libowfat manual, section 3, and it's called iob_addbuf_free. she's the buffer-adding girly who ALSO cleans up after herself. main character behaviour fr fr 🎀

🌸 NAME 🌸

iob_addbuf_free — add a buffer to an I/O batch, but make it the deallocating kind 💅

✨ SYNTAX ✨

#include <libowfat/iob.h>

int iob_addbuf_free(io_batch* b,const void* buf,uint64 n);

🦋 DESCRIPTION 🦋

so basically iob_addbuf_free books n bytes, starting at buf, to get written out with the I/O batch b. like, "hey bestie, queue this up for me" 💌

and here's the iconic part: that buffer gets automatically deallocated by iob_reset. no cap, she handles the cleanup herself so you don't have to. self-care queen 👑

⚠️ heads up though: because iob_reset is the one doing the deallocating, that's the whole vibe of this function versus plain old iob_addbuf — don't go freeing that buffer yourself on the side, that's giving double-free energy 💀

🌈 RETURN VALUE 🌈

• 1 — slay, it worked ✨
• 0 — nope, it did not work

and in the failure case? the buffer was deallocated anyway. so like, even when she fails she still took the trash out 🗑️ (so please don't free it again after that, iykyk)

🫶 SEE ALSO 🫶

• iob_reset(3)
• iob_send(3)
• iob_addbuf(3)
• iob_adds(3)
• iob_addfile(3)

and that's the whole page bestie, hope it ate 💖 this was the iob_addbuf_free(3) page from the Library Functions Manual, and yeah, the footer just says iob_addbuf_free(3) right back at you — no fancy version or date, she's mysterious like that 🙈✨