al_cstr_dup(3)

🦋 al_cstr_dup(3) — bestie edition 🦋

okay so welcome to the Library Functions Manual side of the Allegro 5 universe 💖 this page is all about al_cstr_dup, and it’s lowkey a tiny string-copying icon. no cap.

---

✨ NAME ✨

al_cstr_dup — Allegro 5 API

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

char *al_cstr_dup(const ALLEGRO_USTR *us)

💖 DESCRIPTION 💖

okay so al_cstr_dup makes a NUL ('\0') terminated copy of the string. 🎀

and yes bestie, any embedded NUL bytes will still be presented in the returned string — no sneaky dropping, fr fr. 💅

the new string must eventually be freed with al_free(3) — that’s a must, not a maybe, okay? 🫶

if an error occurs, NULL is returned. that’s the signal. 😭

🌈 SEE ALSO 🌈

go give these a lil look, iykyk:

• al_cstr(3)
• al_ustr_to_buffer(3)
• al_free(3)

---

xoxo, from the Allegro reference manual 💖 — page al_cstr_dup(3), no date listed on this cutie. 🦋✨