stralloc_copy(3)

💖 NAME 💖

stralloc_copy — copy data into a stralloc 🫶

okay so real quick, before we even get into it: this is page stralloc_copy(3) from the Library Functions Manual, part of libowfat. she's a section 3 library function, she's iconic, and she's about to make your stralloc hold a whole new string. let's GO 💅

📜 SYNTAX 📜

#include <libowfat/stralloc.h>

int stralloc_copy(stralloc* sato,stralloc* safrom);

🌸 DESCRIPTION 🌸

So. stralloc_copy copies the string stored in safrom into sa. no cap. it's literally the same thing as calling:

stralloc_copyb(&sato, safrom.s, safrom.len)

so if you already know stralloc_copyb you already know her, she's just the glow-up version that takes a whole stralloc as the source instead of a raw pointer plus a length. ✨

⚠️ heads up bestie: safrom must already be allocated. don't come at her with an unallocated source, she will not be doing that for you. 🙈

the data that sa previously contained? overwritten and truncated. gone. deceased. not coming back. 💀 so if you cared about whatever was in there before, you should've copied it somewhere else first, that's on you.

and if stralloc_copy has trouble allocating memory — like, the allocator said no — she returns 0. otherwise she returns 1. that's it, that's the whole deal.

🔥 RETURN VALUE 🔥

• 1 — success, we ate, the copy is copied 👑
• 0 — memory allocation failure, the vibe check failed, no memory for you 😭

👀 SEE ALSO 👀

• stralloc_copyb(3)

and that's the page!! 🎀 tysm for reading, this was stralloc_copy(3) from the Library Functions Manual (libowfat's own), and yes she's giving library-functions-manual realness. mwah, bye bestie 💜🦋