GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SET_UCODEPAGE (3)

NAME

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

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

void set_ucodepage(const unsigned short *table, const unsigned short *extras);

DESCRIPTION

When you select the U_ASCII_CP encoding mode, a set of tables are used to convert between 8-bit characters and their Unicode equivalents. You can use this function to specify a custom set of mapping tables, which allows you to support different 8-bit codepages.

The ‘table’ parameter points to an array of 256 shorts, which contain the Unicode value for each character in your codepage. The ‘extras’ parameter, if not NULL, points to a list of mapping pairs, which will be used when reducing Unicode data to your codepage. Each pair consists of a Unicode value, followed by the way it should be represented in your codepage. The list is terminated by a zero Unicode value. This allows you to create a many->one mapping, where many different Unicode characters can be represented by a single codepage value (eg. for reducing accented vowels to 7-bit ASCII).

Allegro will use the ‘table’ parameter when it needs to convert an ASCII string to an Unicode string. But when Allegro converts an Unicode string to ASCII, it will use both parameters. First, it will loop through the ‘table’ parameter looking for an index position pointing at the Unicode value it is trying to convert (ie. the ‘table’ parameter is also used for reverse matching). If that fails, the ‘extras’ list is used. If that fails too, Allegro will put the character ‘^’, giving up the conversion.

Note that Allegro comes with a default ‘table’ and ‘extras’ parameters set internally. The default ‘table’ will convert 8-bit characters to ‘^’. The default ‘extras’ list reduces Latin-1 and Extended-A characters to 7 bits in a sensible way (eg. an accented vowel will be reduced to the same vowel without the accent).

SEE ALSO

set_uformat(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro SET_UCODEPAGE (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.