buffer_put(3)

💖 buffer_put — the manual page, but make it slay 💖

okay bestie, welcome to libowfat and specifically the page for buffer_put(3) — yes that's the Library Functions Manual, we're in the big leagues now. grab a strawberry 🍓 and let's go.

✨ NAME ✨

buffer_put — write binary data to a buffer, no cap

✨ SYNTAX ✨

#include <libowfat/buffer.h>

int buffer_put(buffer* b,const char* x,size_t len);

🦋 DESCRIPTION 🦋

so buffer_put writes len bytes from x to b. that's the whole vibe. binary data, straight into the buffer, periodt. 💅

but here's the tea, and it's the only thing that makes this different from its cousin buffer_putalign:

when there isn't enough space for the new data, buffer_put calls buffer_flush before copying any data. it does not try to squeeze a lil bit in first. it sees there's no room, it flushes, done. meanwhile buffer_putalign is out here filling all the available space with data before it calls buffer_flush. two totally different strategies, both iconic in their own way. 🫶

so like — buffer_put = flush first, copy after. buffer_putalign = pack it in, then flush. iykyk.

👑 RETURN VALUE 👑

• returns 0 when everything was fine ✨ slay
• returns -1 on error, and it sets errno so you can go find out what went wrong 😭

🌈 SEE ALSO 🌈

• buffer_putalign(3)
• buffer_puts(3)
• buffer_flush(3)
• buffer(3)

okay that's the whole page bestie, you ate it 💖 go forth and buffer responsibly. this was buffer_put(3) from the Library Functions Manual — mwah, no notes, signing off 🎀✨