Provided by: allegro5-doc_5.2.8.0+dfsg-1_all bug

NAME

       al_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.  Therefore to pass an
       ALLEGRO_USTR as a parameter you must use al_cstr(3alleg5), 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  is 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(3alleg5) then use the “%s” specifier.  Remember
       to NUL terminate the buffer.

SEE ALSO

       al_ustr_new(3alleg5), al_ustr_appendf(3alleg5)