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

NAME

6       set_ucodepage  -  Sets 8-bit to Unicode conversion tables. Allegro game
7       programming library.
8

SYNOPSIS

10       #include <allegro.h>
11
12
13       void set_ucodepage(const unsigned short *table,  const  unsigned  short
14       *extras);
15

DESCRIPTION

17       When  you select the U_ASCII_CP encoding mode, a set of tables are used
18       to convert between 8-bit characters and their Unicode equivalents.  You
19       can  use this function to specify a custom set of mapping tables, which
20       allows you to support different 8-bit codepages.
21
22       The `table' parameter points to an array of 256 shorts,  which  contain
23       the  Unicode  value  for  each character in your codepage. The `extras'
24       parameter, if not NULL, points to a list of mapping pairs,  which  will
25       be used when reducing Unicode data to your codepage. Each pair consists
26       of a Unicode value, followed by the way it  should  be  represented  in
27       your  codepage.   The  list is terminated by a zero Unicode value. This
28       allows you to create a many->one mapping, where many different  Unicode
29       characters  can  be  represented  by  a  single codepage value (eg. for
30       reducing accented vowels to 7-bit ASCII).
31
32       Allegro will use the `table' parameter when  it  needs  to  convert  an
33       ASCII string to an Unicode string. But when Allegro converts an Unicode
34       string to ASCII, it will use  both  parameters.  First,  it  will  loop
35       through the `table' parameter looking for an index position pointing at
36       the Unicode value it is trying to convert (ie. the `table' parameter is
37       also  used  for  reverse matching). If that fails, the `extras' list is
38       used. If that fails too, Allegro will put the character `^', giving  up
39       the conversion.
40
41       Note  that Allegro comes with a default `table' and `extras' parameters
42       set internally. The default `table' will convert  8-bit  characters  to
43       `^'.   The default `extras' list reduces Latin-1 and Extended-A charac‐
44       ters to 7 bits in a sensible way (eg. an accented vowel will be reduced
45       to the same vowel without the accent).
46
47

SEE ALSO

49       set_uformat(3)
50
51
52
53Allegro                          version 4.4.3                set_ucodepage(3)
Impressum