inc/FLclLocale.h

   1 //
   2 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
   3 //
   4 // Licensed under the Apache License, Version 2.0 (the License);
   5 // you may not use this file except in compliance with the License.
   6 // You may obtain a copy of the License at
   7 //
   8 //     http://www.apache.org/licenses/LICENSE-2.0
   9 //
  10 // Unless required by applicable law or agreed to in writing, software
  11 // distributed under the License is distributed on an "AS IS" BASIS,
  12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 // See the License for the specific language governing permissions and
  14 // limitations under the License.
  15 //
  16
  17 /**
  18  * @file        FLclLocale.h
  19  * @brief       This is the header file for the %Locale class.
  20  *
  21  * This header file contains the declarations of the %Locale class.
  22  */
  23 #ifndef _FLCL_LOCALE_H_
  24 #define _FLCL_LOCALE_H_
  25
  26 #include <FBaseObject.h>
  27 #include <FBaseString.h>
  28
  29 namespace Tizen { namespace Locales
  30 {
  31
  32 /**
  33  * @enum        CalendarType
  34  *
  35  * Defines the calendar type.
  36  *
  37  * @since               2.0
  38  */
  39 enum CalendarType
  40 {
  41         CALENDAR_GREGORIAN,             /**< The calendar type: Gregorian calendar (default) */
  42         CALENDAR_BUDDHIST,              /**< The calendar type: Buddhist calendar (same as Gregorian except for the year)  */
  43         CALENDAR_CHINESE,               /**< The calendar type: Traditional Chinese calendar  */
  44         CALENDAR_COPTIC,                /**< The calendar type: Coptic calendar  */
  45         CALENDAR_ETHIOPIC_AMETE_ALEM,   /**< The calendar type: Ethiopic calendar, Amete Alem (epoch approx. 5493 B.C.E.)  */
  46         CALENDAR_ETHIOPIC,              /**< The calendar type: Ethiopic calendar, Amete Mihret (epoch approx. 8 C.E.)  */
  47         CALENDAR_HEBREW,                /**< The calendar type: TraditionalHebrew calendar  */
  48         CALENDAR_INDIAN,                /**< The calendar type: Indian calendar  */
  49         CALENDAR_ISLAMIC,               /**< The calendar type: Astronomical Arabic calendar  */
  50         CALENDAR_ISLAMIC_CIVIL,         /**< The calendar type: Civil (algorithmic) Arabic calendar  */
  51         CALENDAR_JAPANESE,              /**< The calendar type: Japanese Imperial calendar (same as Gregorian except for the year, with one era for each Emperor)  */
  52         CALENDAR_PERSIAN,               /**< The calendar type: Persian calendar  */
  53         CALENDAR_ROC,                   /**< The calendar type: Republic of China calendar  */
  54         CALENDAR_TAIWAN,                /**< The calendar type: Taiwan calendar  */
  55         CALENDAR_ISO8601,               /**< The calendar type: ISO8601 calendar  */
  56         CALENDAR_COUNT,
  57 };
  58
  59 /**
  60  * @enum        LanguageCode
  61  *
  62  * Defines the ISO 639-2 language code. @n
  63  * The LanguageCode enumerator represents the ISO 639-2 language codes. @n
  64  * The specific LanguageCode represents the language code with the locale's ISO-15924 abbreviation script code. @n
  65  * The supported ISO-15924 script codes are Arabic, Cyrillic, Latin, Hans, Hant and Gurmukhi.
  66  *
  67  * @since               2.0
  68  */
  69 enum LanguageCode
  70 {
  71         LANGUAGE_INVALID = -1, /**< An invalid language code */
  72         LANGUAGE_AAR, /**< Afar */
  73         LANGUAGE_ABK, /**< Abkhazian */
  74         LANGUAGE_ACE, /**< Achinese */
  75         LANGUAGE_ACH, /**< Acoli */
  76         LANGUAGE_ADA, /**< Adangme */
  77         LANGUAGE_ADY, /**< Adyghe; Adygei */
  78         LANGUAGE_AFA, /**< Afro-Asiatic languages */
  79         LANGUAGE_AFH, /**< Afrihili */
  80         LANGUAGE_AFR, /**< Afrikaans */
  81         LANGUAGE_AIN, /**< Ainu */
  82         LANGUAGE_AKA, /**< Akan */
  83         LANGUAGE_AKK, /**< Akkadian */
  84         LANGUAGE_SQI, /**< Albanian */
  85         LANGUAGE_ALE, /**< Aleut */
  86         LANGUAGE_ALG, /**< Algonquian languages */
  87         LANGUAGE_ALT, /**< Southern Altai */
  88         LANGUAGE_AMH, /**< Amharic */
  89         LANGUAGE_ANG, /**< English, Old (ca.450-1100) */
  90         LANGUAGE_ANP, /**< Angika */
  91         LANGUAGE_APA, /**< Apache languages */
  92         LANGUAGE_ARA, /**< Arabic */
  93         LANGUAGE_ARC, /**< Official Aramaic (700-300 BCE); Imperial Aramaic (700-300 BCE) */
  94         LANGUAGE_ARG, /**< Aragonese */
  95         LANGUAGE_HYE, /**< Armenian */
  96         LANGUAGE_ARN, /**< Mapudungun; Mapuche */
  97         LANGUAGE_ARP, /**< Arapaho */
  98         LANGUAGE_ART, /**< Artificial languages */
  99         LANGUAGE_ARW, /**< Arawak */
 100         LANGUAGE_ASM, /**< Assamese */
 101         LANGUAGE_AST, /**< Asturian; Bable; Leonese; Asturleonese */
 102         LANGUAGE_ATH, /**< Athapascan languages */
 103         LANGUAGE_AUS, /**< Australian languages */
 104         LANGUAGE_AVA, /**< Avaric */
 105         LANGUAGE_AVE, /**< Avestan */
 106         LANGUAGE_AWA, /**< Awadhi */
 107         LANGUAGE_AYM, /**< Aymara */
 108         LANGUAGE_AZE, /**< Azerbaijani */
 109         LANGUAGE_AZE_ARAB, /**< Azerbaijani (Arabic) */
 110         LANGUAGE_AZE_CYRL, /**< Azerbaijani (Cyrillic) */
 111         LANGUAGE_AZE_LATIN, /**< Azerbaijani (Latin) */
 112         LANGUAGE_BAD, /**< Banda languages */
 113         LANGUAGE_BAI, /**< Bamileke languages */
 114         LANGUAGE_BAK, /**< Bashkir */
 115         LANGUAGE_BAL, /**< Baluchi */
 116         LANGUAGE_BAM, /**< Bambara */
 117         LANGUAGE_BAN, /**< Balinese */
 118         LANGUAGE_EUS, /**< Basque */
 119         LANGUAGE_BAS, /**< Basa */
 120         LANGUAGE_BAT, /**< Baltic languages */
 121         LANGUAGE_BEJ, /**< Beja; Bedawiyet */
 122         LANGUAGE_BEL, /**< Belarusian */
 123         LANGUAGE_BEM, /**< Bemba */
 124         LANGUAGE_BEN, /**< Bengali */
 125         LANGUAGE_BER, /**< Berber languages */
 126         LANGUAGE_BHO, /**< Bhojpuri */
 127         LANGUAGE_BIH, /**< Bihari */
 128         LANGUAGE_BIK, /**< Bikol */
 129         LANGUAGE_BIN, /**< Bini; Edo */
 130         LANGUAGE_BIS, /**< Bislama */
 131         LANGUAGE_BLA, /**< Siksika */
 132         LANGUAGE_BNT, /**< Bantu (Other) */
 133         LANGUAGE_BOS, /**< Bosnian */
 134         LANGUAGE_BRA, /**< Braj */
 135         LANGUAGE_BRE, /**< Breton */
 136         LANGUAGE_BTK, /**< Batak languages */
 137         LANGUAGE_BUA, /**< Buriat */
 138         LANGUAGE_BUG, /**< Buginese */
 139         LANGUAGE_BUL, /**< Bulgarian */
 140         LANGUAGE_MYA, /**< Burmese */
 141         LANGUAGE_BYN, /**< Blin; Bilin */
 142         LANGUAGE_CAD, /**< Caddo */
 143         LANGUAGE_CAI, /**< Central American Indian languages */
 144         LANGUAGE_CAR, /**< Galibi Carib */
 145         LANGUAGE_CAT, /**< Catalan; Valencian */
 146         LANGUAGE_CAU, /**< Caucasian languages */
 147         LANGUAGE_CEB, /**< Cebuano */
 148         LANGUAGE_CEL, /**< Celtic languages */
 149         LANGUAGE_CHA, /**< Chamorro */
 150         LANGUAGE_CHB, /**< Chibcha */
 151         LANGUAGE_CHE, /**< Chechen */
 152         LANGUAGE_CHG, /**< Chagatai */
 153         LANGUAGE_ZHO, /**< Chinese */
 154         LANGUAGE_ZHO_HANS, /**< Chinese (Simplified)  */
 155         LANGUAGE_ZHO_HANT, /**< Chinese (Traditional)  */
 156         LANGUAGE_CHK, /**< Chuukese */
 157         LANGUAGE_CHM, /**< Mari */
 158         LANGUAGE_CHN, /**< Chinook jargon */
 159         LANGUAGE_CHO, /**< Choctaw */
 160         LANGUAGE_CHP, /**< Chipewyan; Dene Suline */
 161         LANGUAGE_CHR, /**< Cherokee */
 162         LANGUAGE_CHU, /**< Church Slavic; Old Slavonic; Church Slavonic; Old Bulgarian; Old Church Slavonic */
 163         LANGUAGE_CHV, /**< Chuvash */
 164         LANGUAGE_CHY, /**< Cheyenne */
 165         LANGUAGE_CMC, /**< Chamic languages */
 166         LANGUAGE_COP, /**< Coptic */
 167         LANGUAGE_COR, /**< Cornish */
 168         LANGUAGE_COS, /**< Corsican */
 169         LANGUAGE_CPE, /**< Creoles and pidgins, English based */
 170         LANGUAGE_CPF, /**< Creoles and pidgins, French-based  */
 171         LANGUAGE_CPP, /**< Creoles and pidgins, Portuguese-based  */
 172         LANGUAGE_CRE, /**< Cree */
 173         LANGUAGE_CRH, /**< Crimean Tatar; Crimean Turkish */
 174         LANGUAGE_CRP, /**< Creoles and pidgins  */
 175         LANGUAGE_CSB, /**< Kashubian */
 176         LANGUAGE_CUS, /**< Cushitic languages */
 177         LANGUAGE_CES, /**< Czech */
 178         LANGUAGE_DAK, /**< Dakota */
 179         LANGUAGE_DAN, /**< Danish */
 180         LANGUAGE_DAR, /**< Dargwa */
 181         LANGUAGE_DAY, /**< Land Dayak languages */
 182         LANGUAGE_DEL, /**< Delaware */
 183         LANGUAGE_DEN, /**< Slave (Athapascan) */
 184         LANGUAGE_DGR, /**< Dogrib */
 185         LANGUAGE_DIN, /**< Dinka */
 186         LANGUAGE_DIV, /**< Divehi; Dhivehi; Maldivian */
 187         LANGUAGE_DOI, /**< Dogri */
 188         LANGUAGE_DRA, /**< Dravidian languages */
 189         LANGUAGE_DSB, /**< Lower Sorbian */
 190         LANGUAGE_DUA, /**< Duala */
 191         LANGUAGE_DUM, /**< Dutch, Middle (ca.1050-1350) */
 192         LANGUAGE_NLD, /**< Dutch; Flemish */
 193         LANGUAGE_DYU, /**< Dyula */
 194         LANGUAGE_DZO, /**< Dzongkha */
 195         LANGUAGE_EFI, /**< Efik */
 196         LANGUAGE_EGY, /**< Egyptian (Ancient) */
 197         LANGUAGE_EKA, /**< Ekajuk */
 198         LANGUAGE_ELX, /**< Elamite */
 199         LANGUAGE_ENG, /**< English */
 200         LANGUAGE_ENM, /**< English, Middle (1100-1500) */
 201         LANGUAGE_EPO, /**< Esperanto */
 202         LANGUAGE_EST, /**< Estonian */
 203         LANGUAGE_EWE, /**< Ewe */
 204         LANGUAGE_EWO, /**< Ewondo */
 205         LANGUAGE_FAN, /**< Fang */
 206         LANGUAGE_FAO, /**< Faroese */
 207         LANGUAGE_FAT, /**< Fanti */
 208         LANGUAGE_FIJ, /**< Fijian */
 209         LANGUAGE_FIL, /**< Filipino; Pilipino */
 210         LANGUAGE_FIN, /**< Finnish */
 211         LANGUAGE_FIU, /**< Finno-Ugrian languages */
 212         LANGUAGE_FON, /**< Fon */
 213         LANGUAGE_FRA, /**< French */
 214         LANGUAGE_FRM, /**< French, Middle (ca.1400-1600) */
 215         LANGUAGE_FRO, /**< French, Old (842-ca.1400) */
 216         LANGUAGE_FRR, /**< Northern Frisian */
 217         LANGUAGE_FRS, /**< Eastern Frisian */
 218         LANGUAGE_FRY, /**< Western Frisian */
 219         LANGUAGE_FUL, /**< Fulah */
 220         LANGUAGE_FUR, /**< Friulian */
 221         LANGUAGE_GAA, /**< Ga */
 222         LANGUAGE_GAY, /**< Gayo */
 223         LANGUAGE_GBA, /**< Gbaya */
 224         LANGUAGE_GEM, /**< Germanic languages */
 225         LANGUAGE_KAT, /**< Georgian */
 226         LANGUAGE_DEU, /**< German */
 227         LANGUAGE_GEZ, /**< Geez */
 228         LANGUAGE_GIL, /**< Gilbertese */
 229         LANGUAGE_GLA, /**< Gaelic; Scottish Gaelic */
 230         LANGUAGE_GLE, /**< Irish */
 231         LANGUAGE_GLG, /**< Galician */
 232         LANGUAGE_GLV, /**< Manx */
 233         LANGUAGE_GMH, /**< German, Middle High (ca.1050-1500) */
 234         LANGUAGE_GOH, /**< German, Old High (ca.750-1050) */
 235         LANGUAGE_GON, /**< Gondi */
 236         LANGUAGE_GOR, /**< Gorontalo */
 237         LANGUAGE_GOT, /**< Gothic */
 238         LANGUAGE_GRB, /**< Grebo */
 239         LANGUAGE_GRC, /**< Greek, Ancient (to 1453) */
 240         LANGUAGE_ELL, /**< Greek, Modern (1453-) */
 241         LANGUAGE_GRN, /**< Guarani */
 242         LANGUAGE_GSW, /**< Swiss German; Alemannic; Alsatian */
 243         LANGUAGE_GUJ, /**< Gujarati */
 244         LANGUAGE_GWI, /**< Gwich'in */
 245         LANGUAGE_HAI, /**< Haida */
 246         LANGUAGE_HAT, /**< Haitian; Haitian Creole */
 247         LANGUAGE_HAU, /**< Hausa */
 248         LANGUAGE_HAU_LATIN, /**< Hausa (Latin) */
 249         LANGUAGE_HAW, /**< Hawaiian */
 250         LANGUAGE_HEB, /**< Hebrew */
 251         LANGUAGE_HER, /**< Herero */
 252         LANGUAGE_HIL, /**< Hiligaynon */
 253         LANGUAGE_HIM, /**< Himachali */
 254         LANGUAGE_HIN, /**< Hindi */
 255         LANGUAGE_HIT, /**< Hittite */
 256         LANGUAGE_HMN, /**< Hmong */
 257         LANGUAGE_HMO, /**< Hiri Motu */
 258         LANGUAGE_HRV, /**< Croatian */
 259         LANGUAGE_HSB, /**< Upper Sorbian */
 260         LANGUAGE_HUN, /**< Hungarian */
 261         LANGUAGE_HUP, /**< Hupa */
 262         LANGUAGE_IBA, /**< Iban */
 263         LANGUAGE_IBO, /**< Igbo */
 264         LANGUAGE_ISL, /**< Icelandic */
 265         LANGUAGE_IDO, /**< Ido */
 266         LANGUAGE_III, /**< Sichuan Yi; Nuosu */
 267         LANGUAGE_IJO, /**< Ijo languages */
 268         LANGUAGE_IKU, /**< Inuktitut */
 269         LANGUAGE_ILE, /**< Interlingue; Occidental */
 270         LANGUAGE_ILO, /**< Iloko */
 271         LANGUAGE_INA, /**< Interlingua (International Auxiliary Language Association) */
 272         LANGUAGE_INC, /**< Indic languages */
 273         LANGUAGE_IND, /**< Indonesian */
 274         LANGUAGE_INE, /**< Indo-European languages */
 275         LANGUAGE_INH, /**< Ingush */
 276         LANGUAGE_IPK, /**< Inupiaq */
 277         LANGUAGE_IRA, /**< Iranian languages */
 278         LANGUAGE_IRO, /**< Iroquoian languages */
 279         LANGUAGE_ITA, /**< Italian */
 280         LANGUAGE_JAV, /**< Javanese */
 281         LANGUAGE_JBO, /**< Lojban */
 282         LANGUAGE_JPN, /**< Japanese */
 283         LANGUAGE_JPR, /**< Judeo-Persian */
 284         LANGUAGE_JRB, /**< Judeo-Arabic */
 285         LANGUAGE_KAA, /**< Kara-Kalpak */
 286         LANGUAGE_KAB, /**< Kabyle */
 287         LANGUAGE_KAC, /**< Kachin; Jingpho */
 288         LANGUAGE_KAL, /**< Kalaallisut; Greenlandic */
 289         LANGUAGE_KAM, /**< Kamba */
 290         LANGUAGE_KAN, /**< Kannada */
 291         LANGUAGE_KAR, /**< Karen languages */
 292         LANGUAGE_KAS, /**< Kashmiri */
 293         LANGUAGE_KAU, /**< Kanuri */
 294         LANGUAGE_KAW, /**< Kawi */
 295         LANGUAGE_KAZ, /**< Kazakh */
 296         LANGUAGE_KAZ_CYRL, /**< Kazakh (Cyrillic)  */
 297         LANGUAGE_KBD, /**< Kabardian */
 298         LANGUAGE_KHA, /**< Khasi */
 299         LANGUAGE_KHI, /**< Khoisan languages */
 300         LANGUAGE_KHM, /**< Central Khmer */
 301         LANGUAGE_KHO, /**< Khotanese; Sakan */
 302         LANGUAGE_KIK, /**< Kikuyu; Gikuyu */
 303         LANGUAGE_KIN, /**< Kinyarwanda */
 304         LANGUAGE_KIR, /**< Kirghiz; Kyrgyz */
 305         LANGUAGE_KMB, /**< Kimbundu */
 306         LANGUAGE_KOK, /**< Konkani */
 307         LANGUAGE_KOM, /**< Komi */
 308         LANGUAGE_KON, /**< Kongo */
 309         LANGUAGE_KOR, /**< Korean */
 310         LANGUAGE_KOS, /**< Kosraean */
 311         LANGUAGE_KPE, /**< Kpelle */
 312         LANGUAGE_KRC, /**< Karachay-Balkar */
 313         LANGUAGE_KRL, /**< Karelian */
 314         LANGUAGE_KRO, /**< Kru languages */
 315         LANGUAGE_KRU, /**< Kurukh */
 316         LANGUAGE_KUA, /**< Kuanyama; Kwanyama */
 317         LANGUAGE_KUM, /**< Kumyk */
 318         LANGUAGE_KUR, /**< Kurdish */
 319         LANGUAGE_KUT, /**< Kutenai */
 320         LANGUAGE_LAD, /**< Ladino */
 321         LANGUAGE_LAH, /**< Lahnda */
 322         LANGUAGE_LAM, /**< Lamba */
 323         LANGUAGE_LAO, /**< Lao */
 324         LANGUAGE_LAT, /**< Latin */
 325         LANGUAGE_LAV, /**< Latvian */
 326         LANGUAGE_LEZ, /**< Lezghian */
 327         LANGUAGE_LIM, /**< Limburgan; Limburger; Limburgish */
 328         LANGUAGE_LIN, /**< Lingala */
 329         LANGUAGE_LIT, /**< Lithuanian */
 330         LANGUAGE_LOL, /**< Mongo */
 331         LANGUAGE_LOZ, /**< Lozi */
 332         LANGUAGE_LTZ, /**< Luxembourgish; Letzeburgesch */
 333         LANGUAGE_LUA, /**< Luba-Lulua */
 334         LANGUAGE_LUB, /**< Luba-Katanga */
 335         LANGUAGE_LUG, /**< Ganda */
 336         LANGUAGE_LUI, /**< Luiseno */
 337         LANGUAGE_LUN, /**< Lunda */
 338         LANGUAGE_LUO, /**< Luo (Kenya and Tanzania) */
 339         LANGUAGE_LUS, /**< Lushai */
 340         LANGUAGE_MKD, /**< Macedonian */
 341         LANGUAGE_MAD, /**< Madurese */
 342         LANGUAGE_MAG, /**< Magahi */
 343         LANGUAGE_MAH, /**< Marshallese */
 344         LANGUAGE_MAI, /**< Maithili */
 345         LANGUAGE_MAK, /**< Makasar */
 346         LANGUAGE_MAL, /**< Malayalam */
 347         LANGUAGE_MAN, /**< Mandingo */
 348         LANGUAGE_MRI, /**< Maori */
 349         LANGUAGE_MAP, /**< Austronesian languages */
 350         LANGUAGE_MAR, /**< Marathi */
 351         LANGUAGE_MAS, /**< Masai */
 352         LANGUAGE_MSA, /**< Malay */
 353         LANGUAGE_MDF, /**< Moksha */
 354         LANGUAGE_MDR, /**< Mandar */
 355         LANGUAGE_MEN, /**< Mende */
 356         LANGUAGE_MGA, /**< Irish, Middle (900-1200) */
 357         LANGUAGE_MIC, /**< Mi'kmaq; Micmac */
 358         LANGUAGE_MIN, /**< Minangkabau */
 359         LANGUAGE_MIS, /**< Uncoded languages */
 360         LANGUAGE_MKH, /**< Mon-Khmer languages */
 361         LANGUAGE_MLG, /**< Malagasy */
 362         LANGUAGE_MLT, /**< Maltese */
 363         LANGUAGE_MNC, /**< Manchu */
 364         LANGUAGE_MNI, /**< Manipuri */
 365         LANGUAGE_MNO, /**< Manobo languages */
 366         LANGUAGE_MOH, /**< Mohawk */
 367         LANGUAGE_MON, /**< Mongolian */
 368         LANGUAGE_MOS, /**< Mossi */
 369         LANGUAGE_MUL, /**< Multiple languages */
 370         LANGUAGE_MUN, /**< Munda languages */
 371         LANGUAGE_MUS, /**< Creek */
 372         LANGUAGE_MWL, /**< Mirandese */
 373         LANGUAGE_MWR, /**< Marwari */
 374         LANGUAGE_MYN, /**< Mayan languages */
 375         LANGUAGE_MYV, /**< Erzya */
 376         LANGUAGE_NAH, /**< Nahuatl languages */
 377         LANGUAGE_NAI, /**< North American Indian languages */
 378         LANGUAGE_NAP, /**< Neapolitan */
 379         LANGUAGE_NAU, /**< Nauru */
 380         LANGUAGE_NAV, /**< Navajo; Navaho */
 381         LANGUAGE_NBL, /**< Ndebele, South; South Ndebele */
 382         LANGUAGE_NDE, /**< Ndebele, North; North Ndebele */
 383         LANGUAGE_NDO, /**< Ndonga */
 384         LANGUAGE_NDS, /**< Low German; Low Saxon; German, Low; Saxon, Low */
 385         LANGUAGE_NEP, /**< Nepali */
 386         LANGUAGE_NEW, /**< Nepal Bhasa; Newari */
 387         LANGUAGE_NIA, /**< Nias */
 388         LANGUAGE_NIC, /**< Niger-Kordofanian languages */
 389         LANGUAGE_NIU, /**< Niuean */
 390         LANGUAGE_NNO, /**< Norwegian Nynorsk; Nynorsk, Norwegian */
 391         LANGUAGE_NOB, /**< Bokmal, Norwegian; Norwegian Bokmal */
 392         LANGUAGE_NOG, /**< Nogai */
 393         LANGUAGE_NON, /**< Norse, Old */
 394         LANGUAGE_NOR, /**< Norwegian */
 395         LANGUAGE_NQO, /**< N'Ko */
 396         LANGUAGE_NSO, /**< Pedi; Sepedi; Northern Sotho */
 397         LANGUAGE_NUB, /**< Nubian languages */
 398         LANGUAGE_NWC, /**< Classical Newari; Old Newari; Classical Nepal Bhasa */
 399         LANGUAGE_NYA, /**< Chichewa; Chewa; Nyanja */
 400         LANGUAGE_NYM, /**< Nyamwezi */
 401         LANGUAGE_NYN, /**< Nyankole */
 402         LANGUAGE_NYO, /**< Nyoro */
 403         LANGUAGE_NZI, /**< Nzima */
 404         LANGUAGE_OCI, /**< Occitan (post 1500); Provencal */
 405         LANGUAGE_OJI, /**< Ojibwa */
 406         LANGUAGE_ORI, /**< Oriya */
 407         LANGUAGE_ORM, /**< Oromo */
 408         LANGUAGE_OSA, /**< Osage */
 409         LANGUAGE_OSS, /**< Ossetian; Ossetic */
 410         LANGUAGE_OTA, /**< Turkish, Ottoman (1500-1928) */
 411         LANGUAGE_OTO, /**< Otomian languages */
 412         LANGUAGE_PAA, /**< Papuan languages */
 413         LANGUAGE_PAG, /**< Pangasinan */
 414         LANGUAGE_PAL, /**< Pahlavi */
 415         LANGUAGE_PAM, /**< Pampanga; Kapampangan */
 416         LANGUAGE_PAN, /**< Panjabi; Punjabi */
 417         LANGUAGE_PAN_ARAB, /**< Panjabi; Punjabi (Arabic)  */
 418         LANGUAGE_PAN_GURU, /**< Panjabi; Punjabi (Gurmukhi)  */
 419         LANGUAGE_PAP, /**< Papiamento */
 420         LANGUAGE_PAU, /**< Palauan */
 421         LANGUAGE_PEO, /**< Persian, Old (ca.600-400 B.C.) */
 422         LANGUAGE_FAS, /**< Persian */
 423         LANGUAGE_PHI, /**< Philippine languages */
 424         LANGUAGE_PHN, /**< Phoenician */
 425         LANGUAGE_PLI, /**< Pali */
 426         LANGUAGE_POL, /**< Polish */
 427         LANGUAGE_PON, /**< Pohnpeian */
 428         LANGUAGE_POR, /**< Portuguese */
 429         LANGUAGE_PRA, /**< Prakrit languages */
 430         LANGUAGE_PRO, /**< Provencal, Old (to 1500) */
 431         LANGUAGE_PUS, /**< Pushto; Pashto */
 432         LANGUAGE_QAA_QTZ, /**< Reserved for local use */
 433         LANGUAGE_QUE, /**< Quechua */
 434         LANGUAGE_RAJ, /**< Rajasthani */
 435         LANGUAGE_RAP, /**< Rapanui */
 436         LANGUAGE_RAR, /**< Rarotongan; Cook Islands Maori */
 437         LANGUAGE_ROA, /**< Romance languages */
 438         LANGUAGE_ROH, /**< Romansh */
 439         LANGUAGE_ROM, /**< Romany */
 440         LANGUAGE_RON, /**< Romanian; Moldavian; Moldovan */
 441         LANGUAGE_RUN, /**< Rundi */
 442         LANGUAGE_RUP, /**< Aromanian; Arumanian; Macedo-Romanian */
 443         LANGUAGE_RUS, /**< Russian */
 444         LANGUAGE_SAD, /**< Sandawe */
 445         LANGUAGE_SAG, /**< Sango */
 446         LANGUAGE_SAH, /**< Yakut */
 447         LANGUAGE_SAI, /**< South American Indian (Other) */
 448         LANGUAGE_SAL, /**< Salishan languages */
 449         LANGUAGE_SAM, /**< Samaritan Aramaic */
 450         LANGUAGE_SAN, /**< Sanskrit */
 451         LANGUAGE_SAS, /**< Sasak */
 452         LANGUAGE_SAT, /**< Santali */
 453         LANGUAGE_SCN, /**< Sicilian */
 454         LANGUAGE_SCO, /**< Scots */
 455         LANGUAGE_SEL, /**< Selkup */
 456         LANGUAGE_SEM, /**< Semitic languages */
 457         LANGUAGE_SGA, /**< Irish, Old (to 900) */
 458         LANGUAGE_SGN, /**< Sign Languages */
 459         LANGUAGE_SHN, /**< Shan */
 460         LANGUAGE_SID, /**< Sidamo */
 461         LANGUAGE_SIN, /**< Sinhala; Sinhalese */
 462         LANGUAGE_SIO, /**< Siouan languages */
 463         LANGUAGE_SIT, /**< Sino-Tibetan languages */
 464         LANGUAGE_SLA, /**< Slavic languages */
 465         LANGUAGE_SLK, /**< Slovak */
 466         LANGUAGE_SLV, /**< Slovenian */
 467         LANGUAGE_SMA, /**< Southern Sami */
 468         LANGUAGE_SME, /**< Northern Sami */
 469         LANGUAGE_SMI, /**< Sami languages */
 470         LANGUAGE_SMJ, /**< Lule Sami */
 471         LANGUAGE_SMN, /**< Inari Sami */
 472         LANGUAGE_SMO, /**< Samoan */
 473         LANGUAGE_SMS, /**< Skolt Sami */
 474         LANGUAGE_SNA, /**< Shona */
 475         LANGUAGE_SND, /**< Sindhi */
 476         LANGUAGE_SNK, /**< Soninke */
 477         LANGUAGE_SOG, /**< Sogdian */
 478         LANGUAGE_SOM, /**< Somali */
 479         LANGUAGE_SON, /**< Songhai languages */
 480         LANGUAGE_SOT, /**< Sotho, Southern */
 481         LANGUAGE_SPA, /**< Spanish; Castilian */
 482         LANGUAGE_SRD, /**< Sardinian */
 483         LANGUAGE_SRN, /**< Sranan Tongo */
 484         LANGUAGE_SRP, /**< Serbian */
 485         LANGUAGE_SRP_CYRL, /**< Serbian (Cyrillic)  */
 486         LANGUAGE_SRP_LATIN, /**< Serbian (Latin)  */
 487         LANGUAGE_SRR, /**< Serer */
 488         LANGUAGE_SSA, /**< Nilo-Saharan languages */
 489         LANGUAGE_SSW, /**< Swati */
 490         LANGUAGE_SUK, /**< Sukuma */
 491         LANGUAGE_SUN, /**< Sundanese */
 492         LANGUAGE_SUS, /**< Susu */
 493         LANGUAGE_SUX, /**< Sumerian */
 494         LANGUAGE_SWA, /**< Swahili */
 495         LANGUAGE_SWE, /**< Swedish */
 496         LANGUAGE_SYC, /**< Classical Syriac */
 497         LANGUAGE_SYR, /**< Syriac */
 498         LANGUAGE_TAH, /**< Tahitian */
 499         LANGUAGE_TAI, /**< Tai languages */
 500         LANGUAGE_TAM, /**< Tamil */
 501         LANGUAGE_TAT, /**< Tatar */
 502         LANGUAGE_TEL, /**< Telugu */
 503         LANGUAGE_TEM, /**< Timne */
 504         LANGUAGE_TER, /**< Tereno */
 505         LANGUAGE_TET, /**< Tetum */
 506         LANGUAGE_TGK, /**< Tajik */
 507         LANGUAGE_TGL, /**< Tagalog */
 508         LANGUAGE_THA, /**< Thai */
 509         LANGUAGE_BOD, /**< Tibetan */
 510         LANGUAGE_TIG, /**< Tigre */
 511         LANGUAGE_TIR, /**< Tigrinya */
 512         LANGUAGE_TIV, /**< Tiv */
 513         LANGUAGE_TKL, /**< Tokelau */
 514         LANGUAGE_TLH, /**< Klingon; tlhIngan-Hol */
 515         LANGUAGE_TLI, /**< Tlingit */
 516         LANGUAGE_TMH, /**< Tamashek */
 517         LANGUAGE_TOG, /**< Tonga (Nyasa) */
 518         LANGUAGE_TON, /**< Tonga (Tonga Islands) */
 519         LANGUAGE_TPI, /**< Tok Pisin */
 520         LANGUAGE_TSI, /**< Tsimshian */
 521         LANGUAGE_TSN, /**< Tswana */
 522         LANGUAGE_TSO, /**< Tsonga */
 523         LANGUAGE_TUK, /**< Turkmen */
 524         LANGUAGE_TUK_CYRL, /**< Turkmen (Cyrillic)  */
 525         LANGUAGE_TUK_LATIN, /**< Turkmen (Latin)  */
 526         LANGUAGE_TUM, /**< Tumbuka */
 527         LANGUAGE_TUP, /**< Tupi languages */
 528         LANGUAGE_TUR, /**< Turkish */
 529         LANGUAGE_TUT, /**< Altaic languages */
 530         LANGUAGE_TVL, /**< Tuvalu */
 531         LANGUAGE_TWI, /**< Twi */
 532         LANGUAGE_TYV, /**< Tuvinian */
 533         LANGUAGE_UDM, /**< Udmurt */
 534         LANGUAGE_UGA, /**< Ugaritic */
 535         LANGUAGE_UIG, /**< Uighur; Uyghur */
 536         LANGUAGE_UKR, /**< Ukrainian */
 537         LANGUAGE_UMB, /**< Umbundu */
 538         LANGUAGE_UND, /**< Undetermined */
 539         LANGUAGE_URD, /**< Urdu */
 540         LANGUAGE_UZB, /**< Uzbek */
 541         LANGUAGE_UZB_ARAB, /**< Uzbek (Arabic) */
 542         LANGUAGE_UZB_CYRL, /**< Uzbek (Cyrillic)  */
 543         LANGUAGE_UZB_LATIN, /**< Uzbek (Latin)  */
 544         LANGUAGE_VAI, /**< Vai */
 545         LANGUAGE_VEN, /**< Venda */
 546         LANGUAGE_VIE, /**< Vietnamese */
 547         LANGUAGE_VLS, /**< Vlaams; Flemish"  */
 548         LANGUAGE_VOL, /**< Volapuk */
 549         LANGUAGE_VOT, /**< Votic */
 550         LANGUAGE_WAK, /**< Wakashan languages */
 551         LANGUAGE_WAL, /**< Walamo */
 552         LANGUAGE_WAR, /**< Waray */
 553         LANGUAGE_WAS, /**< Washo */
 554         LANGUAGE_CYM, /**< Welsh */
 555         LANGUAGE_WEN, /**< Sorbian languages */
 556         LANGUAGE_WLN, /**< Walloon */
 557         LANGUAGE_WOL, /**< Wolof */
 558         LANGUAGE_XAL, /**< Kalmyk; Oirat */
 559         LANGUAGE_XHO, /**< Xhosa */
 560         LANGUAGE_YAO, /**< Yao */
 561         LANGUAGE_YAP, /**< Yapese */
 562         LANGUAGE_YID, /**< Yiddish */
 563         LANGUAGE_YOR, /**< Yoruba */
 564         LANGUAGE_YPK, /**< Yupik languages */
 565         LANGUAGE_ZAP, /**< Zapotec */
 566         LANGUAGE_ZBL, /**< Blissymbols; Blissymbolics; Bliss */
 567         LANGUAGE_ZEN, /**< Zenaga */
 568         LANGUAGE_ZHA, /**< Zhuang; Chuang */
 569         LANGUAGE_ZND, /**< Zande languages */
 570         LANGUAGE_ZUL, /**< Zulu */
 571         LANGUAGE_ZUN, /**< Zuni */
 572         LANGUAGE_ZXX, /**< No linguistic content; Not applicable */
 573         LANGUAGE_ZZA, /**< Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki */
 574         LANGUAGE_MAX, // Language max count
 575
 576     LANGUAGE_INVALID_RESERVED = LANGUAGE_ZZA + 2, // An invalid language code for internal (LANGUAGE_ZZA+2)
 577 }; // LanguageCode
 578
 579
 580 /**
 581  * @enum        CountryCode
 582  *
 583  * Defines the ISO 3166-1 alpha-2 country code. @n
 584  * The CountryCode enumerator represents the ISO 3166-1 alpha-2 country codes.
 585  * The area code for Latin america and the Caribbean represents the ISO 3166-1 numeric-3.
 586  *
 587  * @since               2.0
 588  */
 589 enum CountryCode
 590 {
 591     COUNTRY_INVALID = -1, /**< An invalid country code */
 592         COUNTRY_AF, /**< AFGHANISTAN  */
 593         COUNTRY_AX, /**< ALAND ISLANDS */
 594         COUNTRY_AL, /**< ALBANIA */
 595         COUNTRY_DZ, /**< ALGERIA */
 596         COUNTRY_AS, /**< AMERICAN SAMOA */
 597         COUNTRY_AD, /**< ANDORRA */
 598         COUNTRY_AO, /**< ANGOLA */
 599         COUNTRY_AI, /**< ANGUILLA */
 600         COUNTRY_AQ, /**< ANTARCTICA */
 601         COUNTRY_AG, /**< ANTIGUA AND BARBUDA */
 602         COUNTRY_AR, /**< ARGENTINA */
 603         COUNTRY_AM, /**< ARMENIA */
 604         COUNTRY_AW, /**< ARUBA */
 605         COUNTRY_AU, /**< AUSTRALIA */
 606         COUNTRY_AT, /**< AUSTRIA */
 607         COUNTRY_AZ, /**< AZERBAIJAN */
 608         COUNTRY_BS, /**< BAHAMAS */
 609         COUNTRY_BH, /**< BAHRAIN */
 610         COUNTRY_BD, /**< BANGLADESH */
 611         COUNTRY_BB, /**< BARBADOS */
 612         COUNTRY_BY, /**< BELARUS */
 613         COUNTRY_BE, /**< BELGIUM */
 614         COUNTRY_BZ, /**< BELIZE */
 615         COUNTRY_BJ, /**< BENIN */
 616         COUNTRY_BM, /**< BERMUDA */
 617         COUNTRY_BT, /**< BHUTAN */
 618         COUNTRY_BO, /**< BOLIVIA */
 619         COUNTRY_BA, /**< BOSNIA AND HERZEGOVINA */
 620         COUNTRY_BW, /**< BOTSWANA */
 621         COUNTRY_BV, /**< BOUVET ISLAND */
 622         COUNTRY_BR, /**< BRAZIL */
 623         COUNTRY_IO, /**< BRITISH INDIAN OCEAN TERRITORY */
 624         COUNTRY_BN, /**< BRUNEI DARUSSALAM */
 625         COUNTRY_BG, /**< BULGARIA */
 626         COUNTRY_BF, /**< BURKINA FASO */
 627         COUNTRY_BI, /**< BURUNDI */
 628         COUNTRY_KH, /**< CAMBODIA */
 629         COUNTRY_CM, /**< CAMEROON */
 630         COUNTRY_CA, /**< CANADA */
 631         COUNTRY_CV, /**< CAPE VERDE */
 632         COUNTRY_KY, /**< CAYMAN ISLANDS */
 633         COUNTRY_CF, /**< CENTRAL AFRICAN REPUBLIC */
 634         COUNTRY_TD, /**< CHAD */
 635         COUNTRY_CL, /**< CHILE */
 636         COUNTRY_CN, /**< CHINA */
 637         COUNTRY_CX, /**< CHRISTMAS ISLAND */
 638         COUNTRY_CC, /**< COCOS (KEELING) ISLANDS */
 639         COUNTRY_CO, /**< COLOMBIA */
 640         COUNTRY_KM, /**< COMOROS */
 641         COUNTRY_CG, /**< CONGO */
 642         COUNTRY_CD, /**< CONGO, THE DEMOCRATIC REPUBLIC OF THE */
 643         COUNTRY_CK, /**< COOK ISLANDS */
 644         COUNTRY_CR, /**< COSTA RICA */
 645         COUNTRY_CI, /**< COTE D'IVOIRE */
 646         COUNTRY_HR, /**< CROATIA */
 647         COUNTRY_CU, /**< CUBA */
 648         COUNTRY_CY, /**< CYPRUS */
 649         COUNTRY_CZ, /**< CZECH REPUBLIC */
 650         COUNTRY_DK, /**< DENMARK */
 651         COUNTRY_DJ, /**< DJIBOUTI */
 652         COUNTRY_DM, /**< DOMINICA */
 653         COUNTRY_DO, /**< DOMINICAN REPUBLIC */
 654         COUNTRY_EC, /**< ECUADOR */
 655         COUNTRY_EG, /**< EGYPT */
 656         COUNTRY_SV, /**< EL SALVADOR */
 657         COUNTRY_GQ, /**< EQUATORIAL GUINEA */
 658         COUNTRY_ER, /**< ERITREA */
 659         COUNTRY_EE, /**< ESTONIA */
 660         COUNTRY_ET, /**< ETHIOPIA */
 661         COUNTRY_FK, /**< FALKLAND ISLANDS (MALVINAS) */
 662         COUNTRY_FO, /**< FAROE ISLANDS */
 663         COUNTRY_FJ, /**< FIJI */
 664         COUNTRY_FI, /**< FINLAND */
 665         COUNTRY_FR, /**< FRANCE */
 666         COUNTRY_GF, /**< FRENCH GUIANA */
 667         COUNTRY_PF, /**< FRENCH POLYNESIA */
 668         COUNTRY_TF, /**< FRENCH SOUTHERN TERRITORIES */
 669         COUNTRY_GA, /**< GABON  */
 670         COUNTRY_GM, /**< GAMBIA */
 671         COUNTRY_GE, /**< GEORGIA */
 672         COUNTRY_DE, /**< GERMANY */
 673         COUNTRY_GH, /**< GHANA */
 674         COUNTRY_GI, /**< GIBRALTAR */
 675         COUNTRY_GR, /**< GREECE */
 676         COUNTRY_GL, /**< GREENLAND */
 677         COUNTRY_GD, /**< GRENADA */
 678         COUNTRY_GP, /**< GUADELOUPE */
 679         COUNTRY_GU, /**< GUAM */
 680         COUNTRY_GT, /**< GUATEMALA */
 681         COUNTRY_GN, /**< GUINEA */
 682         COUNTRY_GW, /**< GUINEA-BISSAU */
 683         COUNTRY_GY, /**< GUYANA */
 684         COUNTRY_HT, /**< HAITI */
 685         COUNTRY_HM, /**< HEARD ISLAND AND MCDONALD ISLANDS */
 686         COUNTRY_VA, /**< HOLY SEE (VATICAN CITY STATE) */
 687         COUNTRY_HN, /**< HONDURAS */
 688         COUNTRY_HK, /**< HONG KONG */
 689         COUNTRY_HU, /**< HUNGARY */
 690         COUNTRY_IS, /**< ICELAND */
 691         COUNTRY_IN, /**< INDIA */
 692         COUNTRY_ID, /**< INDONESIA */
 693         COUNTRY_IR, /**< IRAN, ISLAMIC REPUBLIC OF */
 694         COUNTRY_IQ, /**< IRAQ */
 695         COUNTRY_IE, /**< IRELAND */
 696         COUNTRY_IL, /**< ISRAEL */
 697         COUNTRY_IT, /**< ITALY */
 698         COUNTRY_JM, /**< JAMAICA */
 699         COUNTRY_JP, /**< JAPAN */
 700         COUNTRY_JO, /**< JORDAN */
 701         COUNTRY_KZ, /**< KAZAKHSTAN */
 702         COUNTRY_KE, /**< KENYA */
 703         COUNTRY_KI, /**< KIRIBATI */
 704         COUNTRY_KP, /**< KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF */
 705         COUNTRY_KR, /**< KOREA, REPUBLIC OF */
 706         COUNTRY_KW, /**< KUWAIT */
 707         COUNTRY_KG, /**< KYRGYZSTAN */
 708         COUNTRY_LA, /**< LAO PEOPLE'S DEMOCRATIC REPUBLIC  */
 709         COUNTRY_LV, /**< LATVIA */
 710         COUNTRY_LB, /**< LEBANON */
 711         COUNTRY_LS, /**< LESOTHO */
 712         COUNTRY_LR, /**< LIBERIA */
 713         COUNTRY_LY, /**< LIBYAN ARAB JAMAHIRIYA */
 714         COUNTRY_LI, /**< LIECHTENSTEIN */
 715         COUNTRY_LT, /**< LITHUANIA */
 716         COUNTRY_LU, /**< LUXEMBOURG */
 717         COUNTRY_MO, /**< MACAO */
 718         COUNTRY_MK, /**< MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF */
 719         COUNTRY_MG, /**< MADAGASCAR */
 720         COUNTRY_MW, /**< MALAWI */
 721         COUNTRY_MY, /**< MALAYSIA */
 722         COUNTRY_MV, /**< MALDIVES */
 723         COUNTRY_ML, /**< MALI */
 724         COUNTRY_MT, /**< MALTA */
 725         COUNTRY_MH, /**< MARSHALL ISLANDS */
 726         COUNTRY_MQ, /**< MARTINIQUE */
 727         COUNTRY_MR, /**< MAURITANIA */
 728         COUNTRY_MU, /**< MAURITIUS */
 729         COUNTRY_YT, /**< MAYOTTE */
 730         COUNTRY_MX, /**< MEXICO */
 731         COUNTRY_FM, /**< MICRONESIA, FEDERATED STATES OF */
 732         COUNTRY_MD, /**< MOLDOVA, REPUBLIC OF */
 733         COUNTRY_MC, /**< MONACO */
 734         COUNTRY_MN, /**< MONGOLIA */
 735         COUNTRY_MS, /**< MONTSERRAT */
 736         COUNTRY_MA, /**< MOROCCO */
 737         COUNTRY_MZ, /**< MOZAMBIQUE */
 738         COUNTRY_MM, /**< MYANMAR */
 739         COUNTRY_NA, /**< NAMIBIA */
 740         COUNTRY_NR, /**< NAURU */
 741         COUNTRY_NP, /**< NEPAL */
 742         COUNTRY_NL, /**< NETHERLANDS */
 743         COUNTRY_AN, /**< NETHERLANDS ANTILLES */
 744         COUNTRY_NC, /**< NEW CALEDONIA */
 745         COUNTRY_NZ, /**< NEW ZEALAND */
 746         COUNTRY_NI, /**< NICARAGUA */
 747         COUNTRY_NE, /**< NIGER */
 748         COUNTRY_NG, /**< NIGERIA */
 749         COUNTRY_NU, /**< NIUE */
 750         COUNTRY_NF, /**< NORFOLK ISLAND */
 751         COUNTRY_MP, /**< NORTHERN MARIANA ISLANDS */
 752         COUNTRY_NO, /**< NORWAY */
 753         COUNTRY_OM, /**< OMAN */
 754         COUNTRY_PK, /**< PAKISTAN */
 755         COUNTRY_PW, /**< PALAU */
 756         COUNTRY_PS, /**< PALESTINIAN TERRITORY, OCCUPIED */
 757         COUNTRY_PA, /**< PANAMA */
 758         COUNTRY_PG, /**< PAPUA NEW GUINEA */
 759         COUNTRY_PY, /**< PARAGUAY */
 760         COUNTRY_PE, /**< PERU */
 761         COUNTRY_PH, /**< PHILIPPINES */
 762         COUNTRY_PN, /**< PITCAIRN */
 763         COUNTRY_PL, /**< POLAND */
 764         COUNTRY_PT, /**< PORTUGAL */
 765         COUNTRY_PR, /**< PUERTO RICO */
 766         COUNTRY_QA, /**< QATAR */
 767         COUNTRY_RE, /**< REUNION */
 768         COUNTRY_RO, /**< ROMANIA */
 769         COUNTRY_RU, /**< RUSSIAN FEDERATION */
 770         COUNTRY_RW, /**< RWANDA */
 771         COUNTRY_SH, /**< SAINT HELENA  */
 772         COUNTRY_KN, /**< SAINT KITTS AND NEVIS */
 773         COUNTRY_LC, /**< SAINT LUCIA */
 774         COUNTRY_PM, /**< SAINT PIERRE AND MIQUELON */
 775         COUNTRY_VC, /**< SAINT VINCENT AND THE GRENADINES */
 776         COUNTRY_WS, /**< SAMOA */
 777         COUNTRY_SM, /**< SAN MARINO */
 778         COUNTRY_ST, /**< SAO TOME AND PRINCIPE */
 779         COUNTRY_SA, /**< SAUDI ARABIA */
 780         COUNTRY_SN, /**< SENEGAL */
 781         COUNTRY_SC, /**< SEYCHELLES */
 782         COUNTRY_SL, /**< SIERRA LEONE */
 783         COUNTRY_SG, /**< SINGAPORE */
 784         COUNTRY_SK, /**< SLOVAKIA */
 785         COUNTRY_SI, /**< SLOVENIA */
 786         COUNTRY_SB, /**< SOLOMON ISLANDS */
 787         COUNTRY_SO, /**< SOMALIA */
 788         COUNTRY_ZA, /**< SOUTH AFRICA */
 789         COUNTRY_GS, /**< SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS */
 790         COUNTRY_ES, /**< SPAIN */
 791         COUNTRY_LK, /**< SRI LANKA */
 792         COUNTRY_SD, /**< SUDAN */
 793         COUNTRY_SR, /**< SURINAME */
 794         COUNTRY_SJ, /**< SVALBARD AND JAN MAYEN */
 795         COUNTRY_SZ, /**< SWAZILAND */
 796         COUNTRY_SE, /**< SWEDEN */
 797         COUNTRY_CH, /**< SWITZERLAND */
 798         COUNTRY_SY, /**< SYRIAN ARAB REPUBLIC */
 799         COUNTRY_TW, /**< TAIWAN, PROVINCE OF CHINA */
 800         COUNTRY_TJ, /**< TAJIKISTAN */
 801         COUNTRY_TZ, /**< TANZANIA, UNITED REPUBLIC OF */
 802         COUNTRY_TH, /**< THAILAND */
 803         COUNTRY_TL, /**< TIMOR-LESTE */
 804         COUNTRY_TG, /**< TOGO */
 805         COUNTRY_TK, /**< TOKELAU */
 806         COUNTRY_TO, /**< TONGA */
 807         COUNTRY_TT, /**< TRINIDAD AND TOBAGO */
 808         COUNTRY_TN, /**< TUNISIA */
 809         COUNTRY_TR, /**< TURKEY */
 810         COUNTRY_TM, /**< TURKMENISTAN */
 811         COUNTRY_TC, /**< TURKS AND CAICOS ISLANDS */
 812         COUNTRY_TV, /**< TUVALU */
 813         COUNTRY_UG, /**< UGANDA */
 814         COUNTRY_UA, /**< UKRAINE */
 815         COUNTRY_AE, /**< UNITED ARAB EMIRATES */
 816         COUNTRY_GB, /**< UNITED KINGDOM */
 817         COUNTRY_US, /**< UNITED STATES */
 818         COUNTRY_UM, /**< UNITED STATES MINOR OUTLYING ISLANDS */
 819         COUNTRY_UY, /**< URUGUAY */
 820         COUNTRY_UZ, /**< UZBEKISTAN */
 821         COUNTRY_VU, /**< VANUATU */
 822         COUNTRY_VE, /**< VENEZUELA */
 823         COUNTRY_VN, /**< VIET NAM */
 824         COUNTRY_VG, /**< VIRGIN ISLANDS, BRITISH */
 825         COUNTRY_VI, /**< VIRGIN ISLANDS, U.S. */
 826         COUNTRY_WF, /**< WALLIS AND FUTUNA */
 827         COUNTRY_EH, /**< WESTERN SAHARA */
 828         COUNTRY_YE, /**< YEMEN */
 829         COUNTRY_ZM, /**< ZAMBIA */
 830         COUNTRY_ZW, /**< ZIMBABWE */
 831         COUNTRY_RS, /**< SERBIA */
 832         COUNTRY_ME, /**< MONTENEGRO */
 833         COUNTRY_BL, /**< SAINT BARTHELEMY @b Since: @b 2.1  */
 834         COUNTRY_MF, /**< SAINT MARTIN (FRENCH PART) @b Since: @b 2.1 */
 835         COUNTRY_AREA_419, /**< Latin America and the Caribbean @b Since: @b 2.1  */
 836         COUNTRY_MAX,    //< Country max count
 837
 838     COUNTRY_INVALID_RESERVED = COUNTRY_ME + 2, // An invalid country code for internal (COUNTRY_ME+2)
 839 };
 840
 841
 842 /**
 843  * @class               Locale
 844  * @brief               This class is for the locale identification.
 845  *
 846  * @since               2.0
 847  *
 848  * @final       This class is not intended for extension.
 849  *
 850  * @remarks     For more information on the example codes for %Locale class, see LocaleManager.
 851  *
 852  * The %Locale class represents a specific geographical, political, or cultural region. @n
 853  * A %Locale object has three attributes:
 854  * - Language Code
 855  * - Country Code
 856  * - Variant Code
 857  *
 858  * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/lang_country_codes.htm">Retrieving Language and Country Codes</a>.
 859  *
 860  * @see LanguageCode
 861  * @see CountryCode
 862  * @see LocaleManager
 863  */
 864
 865 class _OSP_EXPORT_ Locale
 866         : public Tizen::Base::Object
 867 {
 868 public:
 869         /**
 870          * Initializes an instance of %Locale with the values of the specified locale. @n
 871          * Copying of objects using this copy constructor is allowed.
 872          *
 873          * @since                               2.0
 874          *
 875          * @param[in]                   otherLocale                     An instance of %Locale
 876          */
 877         Locale(const Locale& otherLocale);
 878
 879         /**
 880          * Initializes an instance of %Locale with the specified language, country, and variant code.
 881          *
 882          * @since                               2.0
 883          *
 884          * @param[in]                   languageCode                                    The language code
 885          * @param[in]                   countryCode                                             The country code
 886          * @param[in]                   pVariantCodeString                              A pointer to the variant code string @n
 887          *                                                                              It is converted to a uppercase letter if it is written in a lowercase letter.
 888          */
 889         Locale(LanguageCode languageCode, CountryCode countryCode, const Tizen::Base::String* pVariantCodeString = null);
 890
 891         /**
 892          * Assigns the value of the specified instance to the current instance of %Locale. @n
 893          * Copying of objects using this copy assignment operator is allowed.
 894          *
 895          * @since                               2.0
 896          *
 897          * @return                      A reference to the current instance of %Locale
 898          * @param[in]           otherLocale                                                     An instance of %Locale
 899          */
 900         Locale& operator =(const Locale& otherLocale);
 901
 902         /**
 903          * This is the destructor for this class. @n
 904          * This destructor overrides Tizen::Base::Object::~Object().
 905          *
 906          * @since               2.0
 907          */
 908         virtual ~Locale(void);
 909
 910         /**
 911          * Compares the current instance of %Locale with the specified instance of %Locale.
 912          *
 913          * @since                               2.0
 914          *
 915          * @return                      @c true if the value of the specified instance is equal to the value of the current instance, @n
 916          *                                      else @c false
 917          * @param[in]           otherLocale                                             An instance of %Locale
 918          */
 919         bool operator ==(const Locale& otherLocale) const;
 920
 921         /**
 922          * Compares the current instance of %Locale with the specified instance of %Locale.
 923          *
 924          * @since               2.0
 925          *
 926          * @return              @c true if the value of the specified instance is not equal to the value of the current instance, @n
 927          *                              else @c false
 928          * @param[in]   otherLocale             An instance of %Locale
 929          */
 930         bool operator !=(const Locale& otherLocale) const;
 931
 932         /**
 933          *      Converts the operand @c obj to an object of the %Locale type and then compares it with the current instance of %Locale.
 934          *
 935          * @since               2.0
 936          *
 937          * @return              @c true if the value of the current instance is equal to the value of the specified Tizen::Base::Object, @n
 938          *                              else @c false
 939          * @param[in]   obj             The object to compare with the current instance
 940          * @see         Tizen::Base::Object::Equals()
 941          */
 942         virtual bool Equals(const Object& obj) const;
 943
 944         /**
 945          * Gets the hash value of the current instance.
 946          *
 947          * @since               2.0
 948          *
 949          * @return              The hash value of the current instance
 950          */
 951         virtual int GetHashCode(void) const;
 952
 953         /**
 954          * Gets the language code (ISO 639-2 code) of the current instance of %Locale.
 955          *
 956          * @since               2.0
 957          *
 958          * @return              The language code enum value of the instance
 959          *
 960          * @remark              The specific LanguageCode represents the language code with the locale's ISO-15924 abbreviation script code.
 961          */
 962         LanguageCode GetLanguageCode(void) const;
 963
 964         /**
 965          * Gets the country code (ISO 3166-1 alpha-2 code) or the area code (ISO 3166-1 numeric-3 code) of the current instance of %Locale.
 966          *
 967          * @since               2.0
 968          *
 969          * @return              The country code enum value of the instance
 970          */
 971         CountryCode GetCountryCode(void) const;
 972
 973         /**
 974          * Gets the language code (ISO 639-2 code) string of the current instance of %Locale.
 975          *
 976          * @since               2.0
 977          *
 978          * @return              The language code, @n
 979          *                      The specific language code string has the locale's ISO-15924 abbreviation script code.
 980          */
 981         Tizen::Base::String GetLanguageCodeString(void) const;
 982
 983         /**
 984          * Gets the country code (ISO 3166-1 alpha-2 code) or the area code (ISO 3166-1 numeric-3 code) string of the current instance of %Locale.
 985          *
 986          * @since               2.0
 987          *
 988          * @return              The country code @n
 989          *                              else the area code if the country code represents Latin America.
 990          */
 991         Tizen::Base::String GetCountryCodeString(void) const;
 992
 993         /**
 994          * Gets the variant code string of the current instance of %Locale.
 995          *
 996          * @since               2.0
 997          *
 998          * @return              The variant code string written in a uppercase letter even if it was set to a lowercase letter, @n
 999          *                              else an empty string if the variant is not specified
1000          * @see                 SetVariantCodeString()
1001          */
1002         Tizen::Base::String GetVariantCodeString(void) const;
1003
1004
1005         /**
1006          * Gets the string representing the current instance of %Locale. @n
1007          * The string consists of the values returned by GetLanguageCodeString(), GetCountryCodeString(), and GetVariantCodeString() assembled into a string.
1008          *
1009          * @since                                       2.0
1010          *
1011          * @return                              A concatenated string with the language code string, country code string, and variant string @n
1012          *                                              For example, if the language code is LANGUAGE_ENG, country code is COUNTRY_US, and variant string is empty, @n
1013          *                                              the locale code string is "eng_US".
1014          * @see                                 GetLanguageCodeString()
1015          * @see                                 GetCountryCodeString()
1016          * @see                                 GetVariantCodeString()
1017          */
1018         Tizen::Base::String GetLocaleCodeString(void) const;
1019
1020         /**
1021          * Gets the country name of the current instance of %Locale that is appropriate for display to the user. @n
1022          * The name is localized for this locale. For example, if this locale is eng_US, the name is "United States".
1023          *
1024          * @since                               2.0
1025          *
1026          * @return                              An error code
1027          * @param[out]                  countryName                             The country name of the locale
1028          * @exception                   E_SUCCESS                               The method is successful.
1029          * @exception                   E_UNSUPPORTED_OPERATION The current @c locale does not have country name entry in the database.
1030          */
1031         result GetCountryName(Tizen::Base::String& countryName) const;
1032
1033         /**
1034          * Gets the country name of the current instance of %Locale that is appropriate for display to the user in the specified %Locale. @n
1035          * The country name is localized for the specified locale(@c otherLocale). For example, if
1036          * the current instance of %Locale is fra_FR and the @c otherLocale is eng_US, the name is "France";
1037          * if the current instance is eng_US and the @c otherLocale is fra_FR, the name returned is "Etats-Unis".
1038          *
1039          * @since                                       2.0
1040          *
1041          * @return                                      An error code
1042          * @param[in]                           otherLocale                             An instance of %Locale according to which the country name of the specified %Locale is displayed
1043          * @param[out]                          countryName                             The country name of the locale
1044          * @exception                           E_SUCCESS                               The method is successful.
1045          * @exception                           E_UNSUPPORTED_OPERATION         The specified @c locale is not supported, or the current @c locale does not have country name entry in the database.
1046          */
1047         result GetCountryName(const Locale& otherLocale, Tizen::Base::String& countryName) const;
1048
1049         /**
1050          * Gets the language name of the current instance of %Locale that is appropriate for display to the user. @n
1051          * The name is localized for the locale. For example, if this locale is
1052          * eng_US, the name is "English".
1053          *
1054          * @since                                       2.0
1055          *
1056          * @return                                      An error code
1057          * @param[out]                          languageName            The language name of the locale
1058          * @exception                           E_SUCCESS                       The method is successful.
1059          * @exception                           E_UNSUPPORTED_OPERATION         The current @c locale does not have country name entry in the database.
1060          */
1061         result GetLanguageName(Tizen::Base::String& languageName) const;
1062
1063         /**
1064          * Gets the language name of the current instance of %Locale that is appropriate for display to the user in the specified %Locale. @n
1065          * The name is localized for the specified locale (@c otherLocale). For example, if
1066          * the current instance is fra_FR and the @c otherLocale is eng_US, the name is "French";
1067          * if the current instance is engUS and the @c otherLocale is fra_FR, the name returned is "anglais".
1068          *
1069          * @since                                       2.0
1070          *
1071          * @return                                      An error code
1072          * @param[in]                           otherLocale                             An instance of %Locale according to which the language name of the specified %Locale is displayed
1073          * @param[out]                          languageName                    The language name of the locale
1074          * @exception                           E_SUCCESS                               The method is successful.
1075          * @exception                           E_UNSUPPORTED_OPERATION         The specified @c locale is not supported, or the current @c locale does not have country name entry in the database.
1076          */
1077         result GetLanguageName(const Locale& otherLocale, Tizen::Base::String& languageName) const;
1078
1079         /**
1080          * Sets the variant code with the specified variant code string. @n
1081          * The variant code string is converted to a uppercase letter even if it is set to a lowercase letter.
1082          *
1083          * @since                                       2.0
1084          *
1085          * @param[in]                           pVariantCode                    A pointer to the variant code
1086          */
1087         void SetVariantCodeString(const Tizen::Base::String* pVariantCode = null);
1088
1089         /**
1090          * Gets the language code equivalent to the specified language code string.
1091          *
1092          * @since                       2.0
1093          *
1094          * @param[in]           languageCodeString                              The language code, @n
1095          *                                                                      To get the specified LanguageCode with the locale's ISO-15924 abbreviation script code, @n
1096          *                                                                      the form of languageCodeString should combine the ISO 639-2 language codes and the locale's ISO-15924 abbreviation script code by "-". @n
1097          *                                                                      For example, if the language code is "aze" and the script code is "latn", @n
1098          *                                                                      the languageCodeString is "aze-latn", and the LanguageCode is LANGUAGE_AZE_LATIN.
1099          * @return              An instance of LanguageCode associated with the @c languageCodeString.
1100          */
1101         static LanguageCode StringToLanguageCode(const Tizen::Base::String& languageCodeString);
1102
1103         /**
1104          * Gets the country code equivalent to the specified country code string.
1105          *
1106          * @since                       2.0
1107          *
1108          * @param[in]           countryCodeString                               The country code
1109          * @return              An instance of CountryCode associated with the @c countryCodeString.
1110          */
1111         static CountryCode StringToCountryCode(const Tizen::Base::String& countryCodeString);
1112
1113         /**
1114          * Gets the language code string equivalent to the specified @c languageCode.
1115          *
1116          * @since                       2.0
1117          *
1118          * @param[in]           languageCode                                    The language code
1119          * @return              The language code string associated with the @c languageCode, @n
1120          *                              else an empty string if languageCode is invalid.
1121          * @see StringToLanguageCode()
1122          */
1123         static Tizen::Base::String LanguageCodeToString(LanguageCode languageCode);
1124
1125         /**
1126          * Gets the country code string equivalent to the specified @c countryCode.
1127          *
1128          * @since                       2.0
1129          *
1130          * @param[in]           countryCode                                             The country code
1131          * @return              The ISO 3166-1 alpha-2 country code string associated with the @c countryCode, @n
1132          *                              else an empty string if countryCode is invalid.
1133          */
1134         static Tizen::Base::String CountryCodeToString(CountryCode countryCode);
1135
1136         /**
1137          * Gets the 2-letter language code string equivalent to the specified @c languageCode.
1138          *
1139          * @since                       2.0
1140          *
1141          * @param[in]           languageCode                                    The language code
1142          * @return              The ISO 639-2 language code string associated with the @c languageCode, @n
1143          *                              or The ISO 639-2 language code string with the ISO-15924 script code @n
1144          *                              if the @c languageCode represents The ISO 639-2 language code with the ISO-15924 script code, @n
1145          *                              else an empty string if languageCode is invalid.
1146          */
1147         static Tizen::Base::String LanguageCodeToTwoLetterLanguageCodeString(LanguageCode languageCode);
1148
1149         /**
1150          * Gets the language code equivalent to the specified 2-letter language code string.
1151          *
1152          * @since                       2.0
1153          *
1154          * @param[in]           languageCodeString                              The language code string
1155          * @return              An instance of LanguageCode associated with the @c languageCodeString.
1156          * @see                 StringToLanguageCode()
1157          */
1158         static LanguageCode TwoLetterLanguageCodeStringToLanguageCode(const Tizen::Base::String& languageCodeString);
1159
1160         /**
1161          * Gets the 3-letter country code string equivalent to the specified @c countryCode.
1162          *
1163          * @since                       2.0
1164          *
1165          * @param[in]           countryCode                                             The country code
1166          * @return              The ISO 3166-1 alpha-3 country code string associated with the @c countryCode, @n
1167          *                              else an empty string if countryCode is invalid
1168          * @see                 CountryCodeToString()
1169          * @remark              COUNTRY_AREA_419 returns an empty string, since it is not defined in the ISO 3166-1 alpha-3.
1170          */
1171         static Tizen::Base::String CountryCodeToThreeLetterCountryCodeString(CountryCode countryCode);
1172
1173         /**
1174          * Gets the country code equivalent to the specified 3-letter country code string.
1175          *
1176          * @since                       2.0
1177          *
1178          * @param[in]           countryCodeString                                The country code string
1179          * @return              An instance of CountryCode associated with the @c countryCodeString.
1180          * @see                 StringToCountryCode()
1181          */
1182         static CountryCode ThreeLetterCountryCodeStringToCountryCode(const Tizen::Base::String& countryCodeString);
1183
1184 private:
1185
1186         LanguageCode __languageCode;
1187         CountryCode __countryCode;
1188
1189         friend class _LocaleImpl;
1190         class _LocaleImpl* __pLocaleImpl;
1191
1192 }; // Locale
1193
1194 }} // Tizen::Locales
1195
1196 #endif //_FLCL_LOCALE_H_