DOKK / manpages / debian 10 / allegro4-doc / set_uformat.3alleg4.en
set_uformat(3alleg4) Allegro manual set_uformat(3alleg4)

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

#include <allegro.h>

void set_uformat(int type);

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.

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

version 4.4.2 Allegro