DragonFly On-Line Manual Pages

Search: Section:  

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.2                  set_uformat(3)

Search: Section: