al_ustr_new(3)

💅 al_ustr_new(3) — like, the Allegro 5 API one, bestie

okay so this is from the Library Functions Manual, and it's the page for al_ustr_new. yes, that's the whole name. al_ustr_new — Allegro 5 API. iconic, no notes. 🎀

---

✨ NAME ✨

al_ustr_new — Allegro 5 API (that's it, that's the whole vibe check 🦋)

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

ALLEGRO_USTR *al_ustr_new(const char *s)

look at her. one function, one const char *s, returns an ALLEGRO_USTR *. main character energy fr fr 👑

---

💖 DESCRIPTION 💖

okay so what this does: it creates a new string that contains a copy of the C-style string s. a copy, bestie — like a whole separate string, not just a little pointer situation. 🫶

and here's the part you literally cannot skip: that string must eventually be freed with al_ustr_free(3). must. eventually. no cap. if you don't, that's a leak and we don't do leaks in this group chat. 😭💀

⚠️ real talk: the copy is yours to clean up. al_ustr_free(3) is the one that handles it — don't forget her.

---

🔥 SEE ALSO 🔥

• al_ustr_new_from_buffer(3)
• al_ustr_newf(3)
• al_ustr_dup(3)
• al_ustr_new_from_utf16(3)

like, go read those too, iykyk ✨ the whole al_ustr family is giving found family and honestly? obsessed. 🌈

---

and that's the page!! 💜 this lil slice of the Allegro reference manual brought to you by al_ustr_new(3) — go forth, make your string, free your string, slay. periodt. 🎀🦋⭐