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)