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

FreeBSD Manual Pages

  
 
  

home | help
set_uformat(3)			Allegro	manual			set_uformat(3)

NAME
       set_uformat - Set the global current text encoding format. Allegro game
       programming library.

SYNOPSIS
       #include	<allegro.h>

       void set_uformat(int type);

DESCRIPTION
       Sets  the  current  text	encoding format. This will affect all parts of
       Allegro,	wherever you see a function that returns a char	*, or takes  a
       char * as a parameter. `type' should be one of these values:

	  U_ASCII     -	fixed size, 8-bit ASCII	characters
	  U_ASCII_CP  -	alternative 8-bit codepage (see	set_ucodepage())
	  U_UNICODE   -	fixed size, 16-bit Unicode characters
	  U_UTF8      -	variable size, UTF-8 format Unicode characters

       Although	 you can change	the text format	on the fly, this is not	a good
       idea. Many strings, for example the names of your hardware drivers  and
       any  language translations, are loaded when you call allegro_init(), so
       if you change the encoding format after this, they will be in the wrong
       format, and things will not work	properly. Generally  you  should  only
       call  set_uformat()  once,  before allegro_init(), and then leave it on
       the same	setting	for the	duration of your program.

SEE ALSO
       get_uformat(3), register_uformat(3), set_ucodepage(3),  set_uformat(3),
       uconvert(3),  ustrsize(3),  ugetc(3),  ugetx(3),	 usetc(3),  uwidth(3),
       ucwidth(3), uisok(3),  uoffset(3),  ugetat(3),  usetat(3),  uinsert(3),
       uremove(3), allegro_init(3), exunicod(3)

Allegro				 version 4.4.3			set_uformat(3)

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

home | help