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.	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 is only usable	for ASCII characters (value <=
       127) or if you really mean to output byte values	from 128-255.  To  in-
       sert the	UTF-8 encoding of a code point,	encode it into a memory	buffer
       using  al_utf8_encode(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+14.3.quarterly>

home | help