stralloc_ready(3)

💖 NAME 💖

okay bestie, say hi to stralloc_ready — she's the girl who makes sure your stralloc has room to breathe. That's literally it: provide space in a stralloc. Serving cunt and serving bytes. ✨

🌸 SYNTAX 🌸

so you pull her in like this:

#include <libowfat/stralloc.h>

int stralloc_ready(stralloc* sa,size_t len);

no cap, that's the whole entrance. 🎀

🦋 DESCRIPTION 🦋

okay so here's the tea. stralloc_ready makes sure that sa has enough space allocated to hold len bytes. It's giving personal assistant energy fr fr. Let me break it down:

• if sa is not allocated, stralloc_ready allocates at least len bytes of space, and returns 1. boom, done, slay. 💅
• if sa is already allocated but not enough to hold len bytes, stralloc_ready allocates at least len bytes of space, copies the old string into the new space, frees the old space, and returns 1. iconic behaviour honestly — she moves your whole wardrobe into a bigger closet and tosses the old one. 👑

⚠️ heads up bestie: note that this changes sa.s. like, the pointer itself moves. don't be holding onto a stale sa.s and then acting surprised, iykyk. 🙈

and if stralloc_ready runs out of memory? she leaves sa alone and returns 0. no drama, no half-moved furniture, she just walks out. 💀

🍓 RETURN VALUE 🍓

• 1 — success, we ate 🔥
• 0 — memory allocation failure, tragic but she told you straight 😭

🌈 SEE ALSO 🌈

• stralloc_readyplus(3) — her sister, also iconic, go read her too 💜

and that's the whole page babes!! this one lives in the Library Functions Manual, filed under stralloc_ready(3) — no version, no date, just vibes and one very reliable girl. mwah, love u, go write some C 🫶💖✨