1al_ustr_newf(3)            Library Functions Manual            al_ustr_newf(3)
2
3
4

NAME

6       al_ustr_newf
7

SYNOPSIS

9              #include <allegro5/allegro.h>
10
11              ALLEGRO_USTR *al_ustr_newf(const char *fmt, ...)
12

DESCRIPTION

14       Create a new string using a printf-style format string.
15
16       Notes:
17
18       The “%s” specifier takes C string arguments, not ALLEGRO_USTRs.  There‐
19       fore to pass an ALLEGRO_USTR as a parameter you  must  use  al_cstr(3),
20       and  it must be NUL terminated.  If the string contains an embedded NUL
21       byte everything from that byte onwards will be ignored.
22
23       The “%c” specifier outputs a single byte, not the UTF–8 encoding  of  a
24       code  point.  Therefore it's only usable for ASCII characters (value <=
25       127) or if you really mean to output  byte  values  from  128—255.   To
26       insert the UTF–8 encoding of a code point, encode it into a memory buf‐
27       fer using al_utf8_encode(3) then use the “%s” specifier.   Remember  to
28       NUL terminate the buffer.
29

SEE ALSO

31       al_ustr_new(3), al_ustr_appendf(3)
32
33
34
35Allegro reference manual                                       al_ustr_newf(3)
Impressum