ustrdup(3alleg4)

🦋 NAME 🦋

ustrdup — duplicates a string. From the Allegro game programming library, aka the 3alleg4 manual bestie, we been knew 💅

✨ SYNOPSIS ✨

#include <allegro.h>

char *ustrdup(const char *src)

🌸 DESCRIPTION 🌸

okay so. this function takes the null-terminated string src and copies it into a freshly allocated chunk of memory — like, brand new, nobody else's, all yours. it's literally duplicating the string fr fr 🫶

here's the vibe in action:

void manipulate_string(const char *input_string)
{
   char *temp_buffer = ustrdup(input_string);
   /* Now we can modify temp_buffer */
   ...

see how temp_buffer is a whole separate copy? that's the whole point, no cap. you can do whatever you want to it and the original stays untouched, icon that she is 👑

💖 RETURN VALUE 💖

she hands you back the newly allocated string ✨ — and like, the caller has to free that memory, that's on you bestie, don't just leave her hanging 😭

and if she can't allocate space for the duplicated string? you get NULL. that's it. that's the tea 💀

🎀 SEE ALSO 🎀

• _ustrdup(3alleg4)
• uconvert(3alleg4)
• ustrsize(3alleg4)
• ustrsizez(3alleg4)
• exconfig(3alleg4)

and that's the whole page, babe 🧚 this was Allegro, version 4.4.3, and yes the ustrdup(3alleg4) girlies ate this one up. go free your strings, mwah 💜