al_ustr_newf(3)

💖 NAME 💖

al_ustr_newf — Allegro 5 API, hanging out in the Library Functions Manual (hi bestie 💖).

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

ALLEGRO_USTR *al_ustr_newf(const char *fmt, ...)

🎀 DESCRIPTION 🎀

Okay so al_ustr_newf creates a new string using a printf-style format string. That's the whole main character move, and it ate. ✨

💅 Notes 💅

• The %s specifier takes C string arguments, not ALLEGRO_USTRs. So if you wanna pass an ALLEGRO_USTR as a parameter, you literally must use al_cstr(3), and it must be NUL terminated. If the string contains an embedded NUL byte, everything from that byte onwards will be ignored. 😭
• The %c specifier outputs a single byte, not the UTF-8 encoding of a code point. So it's only usable for ASCII characters (value <= 127) or if you really mean to output byte values from 128–255. To insert the UTF-8 encoding of a code point, encode it into a memory buffer using al_utf8_encode(3) then use the %s specifier. Remember to NUL terminate the buffer, bestie! 🧚

🔥 SEE ALSO 🔥

al_ustr_new(3), al_ustr_appendf(3)

---

That's the vibe from the Allegro reference manual — al_ustr_newf(3), signing off 💜