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

FreeBSD Manual Pages

  
 
  

home | help
al_ustr_newf(3)						       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's 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)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help