stralloc_copys(3)

✨ stralloc_copys(3) ✨

okay bestie, welcome to the Library Functions Manual 💖 this one's called stralloc_copys and it's here to copy data into a stralloc. tiny function, huge slay, let's get into it 🎀

---

🌸 NAME 🌸

stralloc_copys — copy data into a stralloc 🫶

---

🦋 SYNTAX 🦋

#include <libowfat/stralloc.h>

int stralloc_copys(stralloc* sa,const char* buf);

---

💅 DESCRIPTION 💅

so here's the vibe. stralloc_copys copies a \0-terminated string from buf into sa, and it does not copy the \0 itself. just the good stuff before it. ✨

it's literally the same as:

stralloc_copyb(&sa, buf, str_len(buf))

periodt. same energy, same result, no cap. 💯

whatever sa was holding before? gone. overwritten. truncated. it's giving fresh start, main character energy, the old data did not survive the vibe check 💀

now for the important part, and listen closely because this one matters: if stralloc_copys runs out of memory, it leaves sa alone and returns 0. if everything goes fine, it returns 1. that's it. that's the whole deal. 🍓

---

👑 RETURN VALUE 👑

• 1 — success, we ate, no crumbs 🌈
• 0 — memory allocation failure 😭

---

🔥 SEE ALSO 🔥

• stralloc_copyb(3)

---

ngl the whole "leaves sa alone on failure" thing is lowkey iconic? like it doesn't wreck your existing data just because the malloc flopped. respectful. we love a considerate function. 💜

---

okay that's the whole page bestie, mwah 💋 this was stralloc_copys(3) straight out of the Library Functions Manual, and yes iykyk, come back whenever you need to remember which one of these returns a 1 🧚⭐