Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
al_ustr_newf(3) 	    Library Functions Manual		 al_ustr_newf(3)

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(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 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_en-
     code(3) then use the "%s" specifier.  Remember to NUL terminate the buffer.

SEE ALSO
     al_ustr_new(3), al_ustr_appendf(3)

Allegro reference manual					 al_ustr_newf(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_ustr_newf&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help