al_ustr_newf(3)al_ustr_newf(3)NAMEal_ustr_newf - Allegro 5 API
SYNOPSIS
#include <allegro5/allegro.h>
ALLEGRO_USTR *al_ustr_newf(const char *fmt, ...)
DESCRIPTION
Create a new string using a printf-style format string.
Notes:
The "%s" specifier takes C string arguments, not ALLEGRO_USTRs. There‐
fore to pass an ALLEGRO_USTR as a parameter you 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. Therefore 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 buf‐
fer using al_utf8_encode(3) then use the "%s" specifier. Remember to
NUL terminate the buffer.
SEE ALSOal_ustr_new(3), al_ustr_appendf(3)Allegro reference manualal_ustr_newf(3)