Documentation  |   Table of Contents   |  < Previous   |  Next >  

77    PalmLocale.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

In Palm OS Cobalt countries and languages are defined by their respective ISO standard codes, rather than integer values as in previous Palm OS releases. This is reflected in the changes made to PalmLocale.h. As well, two of the country names were misspelled in previous Palm OS releases; this has been corrected in the Palm OS Protein headers.

Deleted APIs ^TOP^

Table 77.1  Deleted macros

Deleted API

Use instead

COUNTRY_VALUE()

Explicitly cast the value to a CountryType. Note, however, that Palm OS Cobalt uses ISO 3166 country codes, which are two-character LmCountryType values.

LANGUAGE_VALUE()

Explicitly cast the value to a LanguageType. Note, however, that Palm OS Cobalt uses ISO 639 language codes, which are two-character LmLanguageType values.

Table 77.2  Deleted #defines 

Deleted API

Use instead

cCountryNum

Nothing.

cMorrocco

cMorocco

cSyranArabRepublic

cSyrianArabRepublic

encodingNameAscii

encodingNameBig5

encodingNameBig5_HKSCS

encodingNameCP1252

encodingNameCP932

encodingNameGB2312

encodingNameHZ

encodingNameISO8859_1

encodingNamePalmGSM

encodingNameShiftJIS

encodingNameUCS2

encodingNameUTF8

lLanguageNum

Nothing.

lUnused

Nothing.

rez

Nothing - this constant was for PalmSource use only.

Modified APIs ^TOP^

Table 77.3  Modified #defines 

Modified API

Description of change

#define cCountryName ((LmCountryType)'XX')

Countries are now identified by an ISO 3166 two-character code.

#define charEncodingMax CHAR_ENCODING_VALUE(91)

The constant value has changed to reflect the number of supported character encodings.

#define lLanguageName ((LmLanguageType)'xx')

Countries are now identified by an ISO 639 two-character code.

Unchanged APIs ^TOP^

Table 77.4  Unchanged macros

CHAR_ENCODING_VALUE()

Table 77.5  Unchanged #defines 

charEncodingAscii

charEncodingAsmo708

charEncodingAsmo708Fr

charEncodingAsmo708Plus

charEncodingBig5

charEncodingBig5Plus

charEncodingBig5_HKSCS

charEncodingCP1250

charEncodingCP1251

charEncodingCP1252

charEncodingCP1253

charEncodingCP1254

charEncodingCP1255

charEncodingCP1255V

charEncodingCP1256

charEncodingCP1257

charEncodingCP1258

charEncodingCP437

charEncodingCP737

charEncodingCP775

charEncodingCP850

charEncodingCP852

charEncodingCP853

charEncodingCP855

charEncodingCP857

charEncodingCP860

charEncodingCP861

charEncodingCP863

charEncodingCP864

charEncodingCP865

charEncodingCP866

charEncodingCP869

charEncodingCP874

charEncodingCP932

charEncodingCP949

charEncodingEucJp

charEncodingEucKr

charEncodingGB2312

charEncodingGBK

charEncodingGSM

charEncodingHZ

charEncodingISO2022CN

charEncodingISO2022Jp

charEncodingISO2022Kr

charEncodingISO8859_1

charEncodingISO8859_2

charEncodingISO8859_3

charEncodingISO8859_4

charEncodingISO8859_5

charEncodingISO8859_6

charEncodingISO8859_7

charEncodingISO8859_8

charEncodingISO8859_8I

charEncodingISO8859_9

charEncodingKoi8

charEncodingKoi8R

charEncodingMacAra

charEncodingMacCyr

charEncodingMacintosh

charEncodingMacIslande

charEncodingMacTurc

charEncodingMacUkraine

charEncodingMacXCroate

charEncodingMacXGr

charEncodingMacXLat2

charEncodingMacXRomania

charEncodingPalmBig5

charEncodingPalmGB

charEncodingPalmGSM

charEncodingPalmLatin

charEncodingPalmSJIS

charEncodingShiftJIS

charEncodingTis620

charEncodingUCS2

charEncodingUCS4

charEncodingUnknown

charEncodingUTF16

charEncodingUTF16BE

charEncodingUTF16LE

charEncodingUTF32

charEncodingUTF32BE

charEncodingUTF32LE

charEncodingUTF7

charEncodingUTF7_IMAP

charEncodingUTF8

charEncodingVietnet

charEncodingViqr

charEncodingViscii

charEncodingVncii

charEncodingXAutoJp

charEncodingXKamenicky

maxEncodingNameLength