Provided by: allegro4-doc_4.4.2-13_all bug

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(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)