stralloc_cats(3)

✨ stralloc_cats(3) ✨

okay bestie, welcome to the Library Functions Manual 💖 this one lives in the libowfat section 3 pages, and it's genuinely one of the most useful little functions ever, no cap.

🎀 NAME 🎀

stralloc_cats — append data to a stralloc 🦋

🌸 SYNTAX 🌸

#include <libowfat/stralloc.h>

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

💅 DESCRIPTION 💅

okay so here's the tea, bestie 🍓 stralloc_cats takes the \0-terminated string sitting in buf and appends it to the end of the string that's stored in sa. it allocates space if it needs to (because obviously it needs to, it's growing the thing) and then it returns 1. iconic behaviour, honestly.

one thing you gotta know: if sa is unallocated, then stralloc_cats is literally the same as stralloc_copys. same energy, same result, it's giving "same function different name" fr fr.

and if it runs out of memory? 😭 tragic, but it handles it gracefully — stralloc_cats leaves sa alone (doesn't touch it, doesn't mangle it, doesn't do anything sketchy) and returns 0. your data stays safe, the vibes stay intact. 🫶

⭐ RETURN VALUE ⭐

• 1 — success, slay, you ate 💅
• 0 — memory allocation failure, we don't talk about it 🙈

👑 SEE ALSO 👑

• stralloc_copyb(3)

and that's the whole page bestie!! 🌈✨ this one came out of the Library Functions Manual, filed under stralloc_cats(3) — go forth and append responsibly, ily 💜🧚