1set_uformat(3)                  Allegro manual                  set_uformat(3)
2
3
4

NAME

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

SYNOPSIS

10       #include <allegro.h>
11
12
13       void set_uformat(int type);
14

DESCRIPTION

16       Sets the current text encoding format. This will affect  all  parts  of
17       Allegro,  wherever you see a function that returns a char *, or takes a
18       char * as a parameter. `type' should be one of these values:
19
20          U_ASCII     - fixed size, 8-bit ASCII characters
21          U_ASCII_CP  - alternative 8-bit codepage (see set_ucodepage())
22          U_UNICODE   - fixed size, 16-bit Unicode characters
23          U_UTF8      - variable size, UTF-8 format Unicode characters
24
25       Although you can change the text format on the fly, this is not a  good
26       idea.  Many strings, for example the names of your hardware drivers and
27       any language translations, are loaded when you call allegro_init(),  so
28       if you change the encoding format after this, they will be in the wrong
29       format, and things will not work properly. Generally  you  should  only
30       call  set_uformat()  once,  before allegro_init(), and then leave it on
31       the same setting for the duration of your program.
32
33

SEE ALSO

35       get_uformat(3), register_uformat(3), set_ucodepage(3),  set_uformat(3),
36       uconvert(3),  ustrsize(3),  ugetc(3),  ugetx(3),  usetc(3),  uwidth(3),
37       ucwidth(3), uisok(3),  uoffset(3),  ugetat(3),  usetat(3),  uinsert(3),
38       uremove(3), allegro_init(3), exunicod(3)
39
40
41
42Allegro                          version 4.2.3                  set_uformat(3)