stralloc_copyb(3)

💖 NAME 💖

okay so bestie, meet stralloc_copyb — the function that copies data into a stralloc ✨

✨ SYNTAX ✨

first things first, you gotta pull in the header:

#include <libowfat/stralloc.h>

and here's the whole vibe of the function signature, character for character:

int stralloc_copyb(stralloc* sa,const char* buf,size_t len);

🦋 DESCRIPTION 🦋

so here's what stralloc_copyb does, and it's honestly so thoughtful of it 🫶

It first makes sure that sa has enough space allocated to hold len bytes. Like, it does the whole "do we have room??" check for you before anything else. Then — and only then — it copies the first len bytes from buf into the stralloc. Slay. 💅

Important vibe check: whatever sa was holding before? Gone. Overwritten. Truncated. It does not preserve the old data, it does not append, it does not pass go. It's giving clean slate energy, and if you were attached to what was in there, that's a you problem, bestie 😭

And now the memory drama: if stralloc_copys runs out of memory, stralloc_copys leaves sa alone and return 0 — otherwise it returns 1. (yes, that's exactly how the page says it, we simply report the lore as it was written 🍓)

ngl the whole point is: it never half-does the job and leaves you with a broken stralloc. Either it works, or sa is untouched. Iconic behaviour, truly. 👑

🎀 RETURN VALUE 🎀

• 1 — success, we ate, no crumbs 🔥
• 0 — memory allocation failure, and it's not you, it's the malloc 😭

and that's the whole page, bestie 💜 this was stralloc_copyb(3) from the Library Functions Manual — go forth, copy bytes, be the main character of your own memory management ✨🎀🦋