inc/FLclLocale.h

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