stralloc_readyplus(3)

💖 stralloc_readyplus — bestie edition 💖

okay so real talk, this one lives in the Library Functions Manual (that's the manual name, she's fancy like that) and her whole job is: making room in a stralloc. no cap. let's get into it. 🎀

---

✨ NAME ✨

stralloc_readyplus — provide space in a stralloc

like... she provides space. that's the whole personality. 💅

---

🌸 SYNTAX 🌸

#include <libowfat/stralloc.h>

int stralloc_readyplus(stralloc* sa,size_t len);

copy that exactly bestie, don't get creative with it 🙈

---

🦋 DESCRIPTION 🦋

okay so stralloc_readyplus makes sure that sa has enough space allocated to hold an additional len bytes. key word: additional. she's adding to what's already there, she's not replacing anything, she's not here to ruin your vibe. 💖

here's the breakdown, and honestly it's giving choose-your-own-adventure:

• If sa is not allocated, stralloc_ready allocates at least len bytes of space, and returns 1. ✨
• If sa is already allocated, but not enough to hold len additional bytes, stralloc_ready allocates at least sa->len+len bytes of space, copies the old string into the new space, frees the old space, and returns 1. she literally moves your whole life into a bigger apartment and then demolishes the old one. iconic behaviour. 👑

⚠️ note that this changes sa.s. so if you were holding onto that pointer like it was your emotional support pointer... it's not the same pointer anymore. the way that this matters is genuinely so important. 😭

and if stralloc_readyplus runs out of memory? she leaves sa alone — untouched, unbothered, not one single change — and returns 0. she would never mess with your data on her way out the door. 🫶

---

💜 RETURN VALUE 💜

• 1 — success, we ate 💅
• 0 — memory allocation failure, we did not eat 😭

---

🌈 SEE ALSO 🌈

• stralloc_ready(3)

---

okay that's the whole page bestie!! this was stralloc_readyplus(3) from the Library Functions Manual — go forth and allocate responsibly, mwah 💋✨🦋🎀💖