path: root/src/corelib/tools/qlocale.qdoc

/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \class QLocale
    \inmodule QtCore
    \brief The QLocale class converts between numbers and their
    string representations in various languages.

    \reentrant
    \ingroup i18n
    \ingroup string-processing
    \ingroup shared


    QLocale is initialized with a language/country pair in its
    constructor and offers number-to-string and string-to-number
    conversion functions similar to those in QString.

    Example:

    \snippet code/src_corelib_tools_qlocale.cpp 0

    QLocale supports the concept of a default locale, which is
    determined from the system's locale settings at application
    startup. The default locale can be changed by calling the
    static member setDefault(). Setting the default locale has the
    following effects:

    \list
    \li If a QLocale object is constructed with the default constructor,
       it will use the default locale's settings.
    \li QString::toInt(), QString::toDouble(), etc., interpret the
       string according to the default locale. If this fails, it
       falls back on the "C" locale.
    \li QString::arg() uses the default locale to format a number when
       its position specifier in the format string contains an 'L',
       e.g. "%L1".
    \endlist

    The following example illustrates how to use QLocale directly:

    \snippet code/src_corelib_tools_qlocale.cpp 1

    When a language/country pair is specified in the constructor, one
    of three things can happen:

    \list
    \li If the language/country pair is found in the database, it is used.
    \li If the language is found but the country is not, or if the country
       is \c AnyCountry, the language is used with the most
       appropriate available country (for example, Germany for German),
    \li If neither the language nor the country are found, QLocale
       defaults to the default locale (see setDefault()).
    \endlist

    Use language() and country() to determine the actual language and
    country values used.

    An alternative method for constructing a QLocale object is by
    specifying the locale name.

    \snippet code/src_corelib_tools_qlocale.cpp 2

    This constructor converts the locale name to a language/country
    pair; it does not use the system locale database.

    \note For the current keyboard input locale take a look at
    QInputMethod::locale().

    QLocale's data is based on Common Locale Data Repository v29.

    \sa QString::arg(), QString::toInt(), QString::toDouble(),
    QInputMethod::locale()
*/

/*!
    \enum QLocale::Language

    This enumerated type is used to specify a language.

    \value AnyLanguage
    \value C The "C" locale is identical in behavior to English/UnitedStates.
    \value Abkhazian
    \value Oromo
    \value Afan Obsolete, please use Oromo
    \value Afar
    \value Afrikaans
    \value Akoose Since Qt 5.3
    \value Albanian
    \value Amharic
    \value Arabic
    \value Armenian
    \value Assamese
    \value Avaric
    \value Aymara
    \value Azerbaijani
    \value Bashkir
    \value Basque
    \value Bengali
    \value Dzongkha
    \value Bhutani Obsolete, please use Dzongkha
    \value Bihari
    \value Bislama
    \value Bosnian
    \value Bodo
    \value Breton
    \value Bulgarian
    \value Burmese
    \value Belarusian
    \value Byelorussian Obsolete, please use Belarusian
    \value Khmer
    \value Cambodian Obsolete, please use Khmer
    \value Catalan
    \value Chamorro
    \value Chechen
    \value Chinese
    \value Church
    \value Chuvash
    \value Cornish
    \value Corsican
    \value Cree
    \value Croatian
    \value Czech
    \value Danish
    \value Divehi
    \value Dutch
    \value English
    \value Esperanto
    \value Estonian
    \value Faroese
    \value Fijian
    \value Finnish
    \value French
    \value WesternFrisian same as Frisian
    \value Frisian same as WesternFrisian
    \value Gaelic
    \value Galician
    \value Georgian
    \value German
    \value Greek
    \value Greenlandic
    \value Guarani
    \value Gujarati
    \value Haitian
    \value Hausa
    \value Hebrew
    \value Herero
    \value Hindi
    \value HiriMotu
    \value Hungarian
    \value Icelandic
    \value Indonesian
    \value Interlingua
    \value Interlingue
    \value Inuktitut
    \value Inupiak
    \value Irish
    \value Italian
    \value Japanese
    \value Javanese
    \value Kannada
    \value Kanuri
    \value Kashmiri
    \value Kazakh
    \value Kinyarwanda
    \value Kirghiz
    \value Komi
    \value Kongo
    \value Korean
    \value Kurdish
    \value Rundi
    \value Kurundi Obsolete, please use Rundi
    \value Kwanyama
    \value Lakota Since Qt 5.3
    \value Lao
    \value Latin
    \value Latvian
    \value Limburgish
    \value Lingala
    \value Lithuanian
    \value LubaKatanga
    \value Luxembourgish
    \value Marshallese
    \value Macedonian
    \value Malagasy
    \value Malay
    \value Malayalam
    \value Maltese
    \value Manx
    \value Maori
    \value Marathi
    \value Moldavian Obsolete, please use Romanian
    \value Mongolian
    \value NauruLanguage
    \value Navaho
    \value Ndonga
    \value Nepali
    \value Norwegian same as NorwegianBokmal
    \value NorwegianBokmal same as Norwegian
    \value NorwegianNynorsk
    \value Occitan
    \value Ojibwa
    \value Oriya
    \value Ossetic
    \value Pali
    \value Pashto
    \value Persian
    \value Polish
    \value Portuguese
    \value Punjabi
    \value Quechua
    \value Romansh
    \value RhaetoRomance Obsolete, please use Romansh
    \value Romanian
    \value Russian
    \value Samoan
    \value Sango
    \value Sanskrit
    \value Sardinian
    \value Serbian
    \value SerboCroatian Obsolete, please use Serbian
    \value SouthernSotho
    \value Tswana
    \value Shona
    \value Sindhi
    \value Sinhala
    \value Swati
    \value Slovak
    \value Slovenian
    \value Somali
    \value Spanish
    \value StandardMoroccanTamazight Since Qt 5.3
    \value Sundanese
    \value Swahili
    \value Swedish
    \value Tagalog Obsolete, please use Filipino
    \value Tahitian
    \value Tajik
    \value Tamil
    \value Tatar
    \value Telugu
    \value Thai
    \value Tibetan
    \value Tigrinya
    \value Tongan
    \value Tsonga
    \value Turkish
    \value Turkmen
    \value Twi Obsolete, please use Akan
    \value Uighur
    \value Uigur Obsolete, please use Uighur
    \value Ukrainian
    \value Urdu
    \value Uzbek
    \value Vietnamese
    \value Volapuk
    \value Walloon
    \value Welsh
    \value Wolof
    \value Xhosa
    \value Yiddish
    \value Yoruba
    \value Zhuang
    \value Zulu
    \value Bosnian
    \value Divehi
    \value Manx
    \value Cornish
    \value Akan
    \value Konkani
    \value Ga
    \value Igbo
    \value Kamba
    \value Syriac
    \value Blin
    \value Geez
    \value Koro
    \value Sidamo
    \value Atsam
    \value Tigre
    \value Jju
    \value Friulian
    \value Venda
    \value Ewe
    \value Walamo
    \value Hawaiian
    \value Tyap
    \value Nyanja
    \value Chewa Obsolete, please use Nyanja
    \value Filipino
    \value SwissGerman
    \value SichuanYi
    \value Kpelle
    \value LowGerman
    \value SouthNdebele
    \value NorthernSotho
    \value NorthernSami
    \value Taroko
    \value Gusii
    \value Taita
    \value Fulah
    \value Kikuyu
    \value Samburu
    \value Sena
    \value NorthNdebele
    \value Rombo
    \value Tachelhit
    \value Kabyle
    \value Nyankole
    \value Bena
    \value Vunjo
    \value Bambara
    \value Embu
    \value Cherokee
    \value Morisyen
    \value Makonde
    \value Langi
    \value Ganda
    \value Bemba
    \value Kabuverdianu
    \value Meru
    \value Kalenjin
    \value Nama
    \value Machame
    \value Colognian
    \value Masai
    \value Soga
    \value Luyia
    \value Asu
    \value Teso
    \value Saho
    \value KoyraChiini
    \value Rwa
    \value Luo
    \value Chiga
    \value CentralMoroccoTamazight
    \value KoyraboroSenni
    \value Shambala
    \value Aghem
    \value Basaa
    \value Zarma
    \value Duala
    \value JolaFonyi
    \value Ewondo
    \value Bafia
    \value MakhuwaMeetto
    \value Mundang
    \value Kwasio
    \value Nuer
    \value Sakha
    \value Sangu
    \value CongoSwahili
    \value Tasawaq
    \value Vai
    \value Walser
    \value Yangben
    \value Avestan
    \value Asturian
    \value Ngomba
    \value Kako
    \value Meta
    \value Ngiemboon
    \value Aragonese
    \value Akkadian
    \value AncientEgyptian
    \value AncientGreek
    \value Aramaic
    \value Balinese
    \value Bamun
    \value BatakToba
    \value Buginese
    \value Buhid
    \value Carian
    \value Chakma
    \value ClassicalMandaic
    \value Coptic
    \value Dogri
    \value EasternCham
    \value EasternKayah
    \value Etruscan
    \value Gothic
    \value Hanunoo
    \value Ingush
    \value LargeFloweryMiao
    \value Lepcha
    \value Limbu
    \value Lisu
    \value Lu
    \value Lycian
    \value Lydian
    \value Mandingo
    \value Manipuri
    \value Meroitic
    \value NorthernThai
    \value OldIrish
    \value OldNorse
    \value OldPersian
    \value OldTurkish
    \value Pahlavi
    \value Parthian
    \value Phoenician
    \value PrakritLanguage
    \value Rejang
    \value Sabaean
    \value Samaritan
    \value Santali
    \value Saurashtra
    \value Sora
    \value Sylheti
    \value Tagbanwa
    \value TaiDam
    \value TaiNua
    \value Ugaritic
    \value Mapuche Since Qt 5.5
    \value CentralKurdish Since Qt 5.5
    \value LowerSorbian Since Qt 5.5
    \value UpperSorbian Since Qt 5.5
    \value Kenyang Since Qt 5.5
    \value Mohawk Since Qt 5.5
    \value Nko Since Qt 5.5
    \value Prussian Since Qt 5.5
    \value Kiche Since Qt 5.5
    \value SouthernSami Since Qt 5.5
    \value LuleSami Since Qt 5.5
    \value InariSami Since Qt 5.5
    \value SkoltSami Since Qt 5.5
    \value Warlpiri Since Qt 5.5
    \value ManichaeanMiddlePersian Since Qt 5.5
    \value Mende Since Qt 5.5
    \value AncientNorthArabian Since Qt 5.5
    \value LinearA Since Qt 5.5
    \value HmongNjua Since Qt 5.5
    \value Ho Since Qt 5.5
    \value Lezghian Since Qt 5.5
    \value Bassa Since Qt 5.5
    \value Mono Since Qt 5.5
    \value TedimChin Since Qt 5.5
    \value Maithili Since Qt 5.5
    \value LowerSorbian Since Qt 5.5
    \value UpperSorbian Since Qt 5.5
    \value Ahom Since Qt 5.7
    \value AmericanSignLanguage Since Qt 5.7
    \value ArdhamagadhiPrakrit Since Qt 5.7
    \value Bhojpuri Since Qt 5.7
    \value Cantonese Since Qt 5.7
    \value HieroglyphicLuwian Since Qt 5.7
    \value LiteraryChinese Since Qt 5.7
    \value Mazanderani Since Qt 5.7
    \value Mru Since Qt 5.7
    \value Newari Since Qt 5.7
    \value NorthernLuri Since Qt 5.7
    \value Osage Since Qt 5.7
    \value Palauan Since Qt 5.7
    \value Papiamento Since Qt 5.7
    \value Saraiki Since Qt 5.7
    \value Tangut Since Qt 5.7
    \value TokelauLanguage Since Qt 5.7
    \value TokPisin Since Qt 5.7
    \value TuvaluLanguage Since Qt 5.7
    \value UncodedLanguages Since Qt 5.7
    \omitvalue LastLanguage

    \sa language(), languageToString()
*/

/*!
    \enum QLocale::Country

    This enumerated type is used to specify a country.

    \value AnyCountry
    \value Afghanistan
    \value Albania
    \value Algeria
    \value AmericanSamoa
    \value Andorra
    \value Angola
    \value Anguilla
    \value Antarctica
    \value AntiguaAndBarbuda
    \value Argentina
    \value Armenia
    \value Aruba
    \value Australia
    \value Austria
    \value Azerbaijan
    \value Bahamas
    \value Bahrain
    \value Bangladesh
    \value Barbados
    \value Belarus
    \value Belgium
    \value Belize
    \value Benin
    \value Bermuda
    \value Bhutan
    \value Bolivia
    \value BosniaAndHerzegowina
    \value Botswana
    \value BouvetIsland
    \value Brazil
    \value BritishIndianOceanTerritory
    \value Brunei
    \value Bulgaria
    \value BurkinaFaso
    \value Burundi
    \value Cambodia
    \value Cameroon
    \value Canada
    \value CanaryIslands
    \value CapeVerde
    \value CaymanIslands
    \value CentralAfricanRepublic
    \value Chad
    \value Chile
    \value China
    \value ChristmasIsland
    \value ClippertonIsland
    \value CocosIslands
    \value Colombia
    \value Comoros
    \value CongoKinshasa
    \value CongoBrazzaville
    \value DemocraticRepublicOfCongo Obsolete, please use CongoKinshasa
    \value PeoplesRepublicOfCongo Obsolete, please use CongoBrazzaville
    \value CookIslands
    \value CostaRica
    \value IvoryCoast
    \value Croatia
    \value Cuba
    \value Cyprus
    \value CzechRepublic
    \value Denmark
    \value Djibouti
    \value Dominica
    \value DominicanRepublic
    \value EastTimor
    \value Ecuador
    \value Egypt
    \value ElSalvador
    \value EquatorialGuinea
    \value Eritrea
    \value Estonia
    \value Ethiopia
    \value EuropeanUnion Since Qt 5.7
    \value FalklandIslands
    \value FaroeIslands
    \value Fiji
    \value Finland
    \value France
    \value FrenchGuiana
    \value FrenchPolynesia
    \value FrenchSouthernTerritories
    \value Gabon
    \value Gambia
    \value Georgia
    \value Germany
    \value Ghana
    \value Gibraltar
    \value Greece
    \value Greenland
    \value Grenada
    \value Guadeloupe
    \value Guam
    \value Guatemala
    \value Guernsey
    \value Guinea
    \value GuineaBissau
    \value Guyana
    \value Haiti
    \value HeardAndMcDonaldIslands
    \value Honduras
    \value HongKong
    \value Hungary
    \value Iceland
    \value India
    \value Indonesia
    \value Iran
    \value Iraq
    \value Ireland
    \value Israel
    \value Italy
    \value Jamaica
    \value Japan
    \value Jordan
    \value Kazakhstan
    \value Kenya
    \value Kiribati
    \value NorthKorea
    \value SouthKorea
    \value DemocraticRepublicOfKorea Obsolete, please use NorthKorea
    \value RepublicOfKorea Obsolete, please use SouthKorea
    \value Kosovo
    \value Kuwait
    \value Kyrgyzstan
    \value Laos
    \value Latvia
    \value Lebanon
    \value Lesotho
    \value Liberia
    \value Libya
    \value Liechtenstein
    \value Lithuania
    \value Luxembourg
    \value Macau
    \value Macedonia
    \value Madagascar
    \value Malawi
    \value Malaysia
    \value Maldives
    \value Mali
    \value Malta
    \value MarshallIslands
    \value Martinique
    \value Mauritania
    \value Mauritius
    \value Mayotte
    \value Mexico
    \value Micronesia
    \value Moldova
    \value Monaco
    \value Mongolia
    \value Montserrat
    \value Morocco
    \value Mozambique
    \value Myanmar
    \value Namibia
    \value NauruCountry
    \value Nepal
    \value Netherlands
    \value NewCaledonia
    \value NewZealand
    \value Nicaragua
    \value Niger
    \value Nigeria
    \value Niue
    \value NorfolkIsland
    \value NorthernMarianaIslands
    \value Norway
    \value Oman
    \value OutlyingOceania Since Qt 5.7
    \value Pakistan
    \value Palau
    \value PalestinianTerritories
    \value Panama
    \value PapuaNewGuinea
    \value Paraguay
    \value Peru
    \value Philippines
    \value Pitcairn
    \value Poland
    \value Portugal
    \value PuertoRico
    \value Qatar
    \value Reunion
    \value Romania
    \value Russia same as RussianFederation
    \value RussianFederation same as Russia
    \value Rwanda
    \value SaintKittsAndNevis
    \value SaintLucia
    \value SaintVincentAndTheGrenadines
    \value Samoa
    \value SanMarino
    \value SaoTomeAndPrincipe
    \value SaudiArabia
    \value Senegal
    \value Seychelles
    \value SierraLeone
    \value Singapore
    \value Slovakia
    \value Slovenia
    \value SolomonIslands
    \value Somalia
    \value SouthAfrica
    \value SouthGeorgiaAndTheSouthSandwichIslands
    \value Spain
    \value SriLanka
    \value SaintHelena
    \value SaintPierreAndMiquelon
    \value Sudan
    \value Suriname
    \value SvalbardAndJanMayenIslands
    \value Swaziland
    \value Sweden
    \value Switzerland
    \value Syria
    \value SyrianArabRepublic Obsolete, please use Syria
    \value Taiwan
    \value Tajikistan
    \value Tanzania
    \value Thailand
    \value Togo
    \value TokelauCountry
    \value Tokelau Obsolete, please use TokelauCountry
    \value Tonga
    \value TrinidadAndTobago
    \value Tunisia
    \value Turkey
    \value Turkmenistan
    \value TurksAndCaicosIslands
    \value TuvaluCountry
    \value Tuvalu Obsolete, please use TuvaluCountry
    \value Uganda
    \value Ukraine
    \value UnitedArabEmirates
    \value UnitedKingdom
    \value UnitedStates
    \value UnitedStatesMinorOutlyingIslands
    \value Uruguay
    \value Uzbekistan
    \value Vanuatu
    \value VaticanCityState
    \value Venezuela
    \value Vietnam
    \value BritishVirginIslands
    \value UnitedStatesVirginIslands
    \value WallisAndFutunaIslands
    \value WesternSahara
    \value Yemen
    \value Zambia
    \value Zimbabwe
    \value Montenegro
    \value Serbia
    \value SaintBarthelemy
    \value SaintMartin
    \value LatinAmericaAndTheCaribbean
    \value AscensionIsland
    \value AlandIslands
    \value DiegoGarcia
    \value CeutaAndMelilla
    \value IsleOfMan
    \value Jersey
    \value TristanDaCunha
    \value SouthSudan
    \value CuraSao
    \value Bonaire
    \value SintMaarten
    \omitvalue LastCountry

    \sa country(), countryToString()
*/

/*!
    \enum QLocale::Script

    This enumerated type is used to specify a script.

    \value AnyScript
    \value AdlamScript Since Qt 5.7
    \value AhomScript Since Qt 5.7
    \value AnatolianHieroglyphsScript Since Qt 5.7
    \value ArabicScript
    \value ArmenianScript
    \value AvestanScript
    \value BalineseScript
    \value BamumScript
    \value BassaVahScript Since Qt 5.5
    \value BatakScript
    \value BengaliScript
    \value BhaiksukiScript Since Qt 5.7
    \value BopomofoScript
    \value BrahmiScript
    \value BrailleScript
    \value BugineseScript
    \value BuhidScript
    \value CanadianAboriginalScript
    \value CarianScript
    \value CaucasianAlbanianScript Since Qt 5.5
    \value ChakmaScript
    \value ChamScript
    \value CherokeeScript
    \value CopticScript
    \value CypriotScript
    \value CyrillicScript
    \value DeseretScript
    \value DevanagariScript
    \value DuployanScript Since Qt 5.5
    \value EgyptianHieroglyphsScript
    \value ElbasanScript Since Qt 5.5
    \value EthiopicScript
    \value FraserScript
    \value GeorgianScript
    \value GlagoliticScript
    \value GothicScript
    \value GranthaScript Since Qt 5.5
    \value GreekScript
    \value GujaratiScript
    \value GurmukhiScript
    \value HanScript
    \value HangulScript
    \value HanunooScript
    \value HanWithBopomofoScript Since Qt 5.7
    \value HatranScript Since Qt 5.7
    \value HebrewScript
    \value HiraganaScript
    \value ImperialAramaicScript
    \value InscriptionalPahlaviScript
    \value InscriptionalParthianScript
    \value JamoScript Since Qt 5.7
    \value JapaneseScript
    \value JavaneseScript
    \value KaithiScript
    \value KannadaScript
    \value KatakanaScript
    \value KayahLiScript
    \value KharoshthiScript
    \value KhmerScript
    \value KhojkiScript Since Qt 5.5
    \value KhudawadiScript Since Qt 5.5
    \value KoreanScript
    \value LannaScript
    \value LaoScript
    \value LatinScript
    \value LepchaScript
    \value LimbuScript
    \value LinearAScript Since Qt 5.5
    \value LinearBScript
    \value LycianScript
    \value LydianScript
    \value MahajaniScript Since Qt 5.5
    \value MalayalamScript
    \value MandaeanScript
    \value ManichaeanScript Since Qt 5.5
    \value MarchenScript Since Qt 5.7
    \value MeiteiMayekScript
    \value MendeKikakuiScript Since Qt 5.5
    \value MeroiticScript
    \value MeroiticCursiveScript
    \value ModiScript Since Qt 5.5
    \value MongolianScript
    \value MroScript Since Qt 5.5
    \value MultaniScript Since Qt 5.7
    \value MyanmarScript
    \value NabataeanScript Since Qt 5.5
    \value NkoScript
    \value NewaScript Since Qt 5.7
    \value NewTaiLueScript
    \value OghamScript
    \value OlChikiScript
    \value OldItalicScript
    \value OldHungarianScript Since Qt 5.7
    \value OldNorthArabianScript Since Qt 5.5
    \value OldPermicScript Since Qt 5.5
    \value OldPersianScript
    \value OldSouthArabianScript
    \value OriyaScript
    \value OrkhonScript
    \value OsageScript Since Qt 5.7
    \value OsmanyaScript
    \value PahawhHmongScript Since Qt 5.5
    \value PalmyreneScript Since Qt 5.5
    \value PauCinHauScript Since Qt 5.5
    \value PhagsPaScript
    \value PhoenicianScript
    \value PollardPhoneticScript
    \value PsalterPahlaviScript Since Qt 5.5
    \value RejangScript
    \value RunicScript
    \value SamaritanScript
    \value SaurashtraScript
    \value SharadaScript
    \value ShavianScript
    \value SiddhamScript Since Qt 5.5
    \value SignWritingScript Since Qt 5.7
    \value SimplifiedHanScript same as SimplifiedChineseScript
    \value SimplifiedChineseScript same as SimplifiedHanScript
    \value SinhalaScript
    \value SoraSompengScript
    \value CuneiformScript
    \value SundaneseScript
    \value SylotiNagriScript
    \value SyriacScript
    \value TagalogScript
    \value TagbanwaScript
    \value TaiLeScript
    \value TaiVietScript
    \value TakriScript
    \value TamilScript
    \value TangutScript Since Qt 5.7
    \value TeluguScript
    \value ThaanaScript
    \value ThaiScript
    \value TibetanScript
    \value TifinaghScript
    \value TirhutaScript Since Qt 5.5
    \value TraditionalHanScript same as TraditionalChineseScript
    \value TraditionalChineseScript same as TraditionalHanScript
    \value UgariticScript
    \value VaiScript
    \value VarangKshitiScript Since Qt 5.5
    \value YiScript
    \omitvalue LastScript

    \sa script(), scriptToString(), languageToString()
*/

/*!
    \enum QLocale::FormatType

    This enum describes the types of format that can be used when
    converting QDate and QTime objects to strings.

    \value LongFormat The long version of day and month names; for
    example, returning "January" as a month name.

    \value ShortFormat The short version of day and month names; for
    example, returning "Jan" as a month name.

    \value NarrowFormat A special version of day and month names for
    use when space is limited; for example, returning "J" as a month
    name. Note that the narrow format might contain the same text for
    different months and days or it can even be an empty string if the
    locale doesn't support narrow names, so you should avoid using it
    for date formatting. Also, for the system locale this format is
    the same as ShortFormat.
*/

/*!
    \enum QLocale::NumberOption

    This enum defines a set of options for number-to-string and string-to-number
    conversions. They can be retrieved with numberOptions() and set with
    setNumberOptions().

    \value DefaultNumberOptions This option represents the default behavior, with
            group separators, with one leading zero in single digit exponents, and
            without trailing zeroes after the decimal dot.
    \value OmitGroupSeparator If this option is set, the number-to-string functions
            will not insert group separators in their return values. The default
            is to insert group separators.
    \value RejectGroupSeparator If this option is set, the string-to-number functions
            will fail if they encounter group separators in their input. The default
            is to accept numbers containing correctly placed group separators.
    \value OmitLeadingZeroInExponent If this option is set, the number-to-string
            functions will not pad exponents with zeroes when printing floating point
            numbers in scientific notation. The default is to add one leading zero to
            single digit exponents.
    \value RejectLeadingZeroInExponent If this option is set, the string-to-number
            functions will fail if they encounter an exponent padded with zeroes when
            parsing a floating point number in scientific notation. The default is to
            accept such padding.
    \value IncludeTrailingZeroesAfterDot If this option is set, the number-to-string
            functions will pad numbers with zeroes to the requested precision in "g"
            or "most concise" mode, even if the number of significant digits is lower
            than the requested precision. The default is to omit trailing zeroes.
    \value RejectTrailingZeroesAfterDot If this option is set, the string-to-number
            functions will fail if they encounter trailing zeroes after the decimal
            dot when parsing a number in scientific or decimal representation. The
            default is to accept trailing zeroes.

    \sa setNumberOptions(), numberOptions()
*/

/*!
    \enum QLocale::FloatingPointPrecisionOption

    This enum defines constants that can be given as precision to QString::number(),
    QByteArray::number(), and QLocale::toString() when converting floats or doubles,
    in order to express a variable number of digits as precision.

    \value FloatingPointShortest The conversion algorithm will try to find the
            shortest accurate representation for the given number. "Accurate" means
            that you get the exact same number back from an inverse conversion on
            the generated string representation.

    \sa toString(), QString, QByteArray

    \since 5.7
*/

/*!
    \enum QLocale::MeasurementSystem

    This enum defines which units are used for measurement.

    \value MetricSystem This value indicates metric units, such as meters,
            centimeters and millimeters.
    \value ImperialUSSystem This value indicates imperial units, such as inches and
            miles as they are used in the United States.
    \value ImperialUKSystem This value indicates imperial units, such as inches and
            miles as they are used in the United Kingdom.
    \value ImperialSystem Provided for compatibility. Same as ImperialUSSystem

    \since 4.4
*/


/*!
    \fn bool QLocale::operator==(const QLocale &other) const

    Returns \c true if the QLocale object is the same as the \a other
    locale specified; otherwise returns \c false.
*/

/*!
    \fn bool QLocale::operator!=(const QLocale &other) const

    Returns \c true if the QLocale object is not the same as the \a other
    locale specified; otherwise returns \c false.
*/

/*!
    \enum QLocale::QuotationStyle

    This enum defines a set of possible styles for locale specific quotation.

    \value StandardQuotation If this option is set, the standard quotation marks
            will be used to quote strings.
    \value AlternateQuotation If this option is set, the alternate quotation marks
            will be used to quote strings.

    \since 4.8

    \sa quoteString()
*/

/*!
    \internal
    \class QSystemLocale
    \inmodule QtCore
    \brief The QSystemLocale class can be used to finetune the system locale
    of the user.
    \since 4.2

    \ingroup i18n

    \warning This class is only useful in very rare cases. Usually QLocale offers
    all the functionality required for application development.

    QSystemLocale allows to override the values provided by the system
    locale (QLocale::system()).

    \sa QLocale
*/

/*!
  \enum QSystemLocale::QueryType

  Specifies the type of information queried by query(). For each value
  the type of information to return from the query() method is listed.

  \value LanguageId a uint specifying the language.
  \value ScriptId a uint specifying the script.
  \value CountryId a uint specifying the country.
  \value DecimalPoint a QString specifying the decimal point.
  \value GroupSeparator a QString specifying the group separator.
  \value ZeroDigit a QString specifying the zero digit.
  \value NegativeSign a QString specifying the minus sign.
  \value PositiveSign a QString specifying the plus sign.
  \value DateFormatLong a QString specifying the long date format
  \value DateFormatShort a QString specifying the short date format
  \value TimeFormatLong a QString specifying the long time format
  \value TimeFormatShort a QString specifying the short time format
  \value DayNameLong a QString specifying the name of a weekday. the in variant contains an integer between 1 and 7 (Monday - Sunday)
  \value DayNameShort a QString specifying the short name of a weekday. the in variant contains an integer between 1 and 7 (Monday - Sunday)
  \value MonthNameLong a QString specifying the name of a month. the in variant contains an integer between 1 and 12
  \value MonthNameShort a QString specifying the short name of a month. the in variant contains an integer between 1 and 12
  \value DateToStringLong converts the QDate stored in the in variant to a QString using the long date format
  \value DateToStringShort converts the QDate stored in the in variant to a QString using the short date format
  \value TimeToStringLong converts the QTime stored in the in variant to a QString using the long time format
  \value TimeToStringShort converts the QTime stored in the in variant to a QString using the short time format
  \value DateTimeFormatLong a QString specifying the long date time format
  \value DateTimeFormatShort a QString specifying the short date time format
  \value DateTimeToStringLong converts the QDateTime in the in variant to a QString using the long datetime format
  \value DateTimeToStringShort converts the QDateTime in the in variant to a QString using the short datetime format
  \value MeasurementSystem a QLocale::MeasurementSystem enum specifying the measurement system
  \value AMText a string that represents the system AM designator associated with a 12-hour clock.
  \value PMText a string that represents the system PM designator associated with a 12-hour clock.
  \value FirstDayOfWeek a Qt::DayOfWeek enum specifiying the first day of the week
  \value CurrencySymbol a string that represents a currency in a format QLocale::CurrencyFormat.
  \value CurrencyToString a localized string representation of a number with a currency symbol. Converts a QSystemLocale::CurrencyToStringArgument stored in the in variant to a QString.
  \value UILanguages a list of strings representing locale names that could be used for UI translation.
  \value StringToStandardQuotation a QString containing a quoted version of the string ref stored in the in variant using standard quotes.
  \value StringToAlternateQuotation a QString containing a quoted version of the string ref stored in the in variant using alternate quotes.
  \value Weekdays a QList<Qt::DayOfWeek> specifying the regular weekdays
  \value LocaleChanged this type is queried whenever the system locale is changed.
  \value ListToSeparatedString a string that represents a join of a given QStringList with a locale-defined separator.
  \value NativeLanguageName a string that represents the name of the native language.
  \value NativeCountryName a string that represents the name of the native country.
*/

/*!
    \fn QLocale QSystemLocale::fallbackUiLocale() const

    \since 4.6
    Returns the fallback locale obtained from the system.
*/

/*!
    \fn QVariant QSystemLocale::query(QueryType type, QVariant in = QVariant()) const

    Generic query method for locale data. Provides indirection.
    Denotes the \a type of the query
    with \a in as input data depending on the query.

    \sa QSystemLocale::QueryType
*/

/*!
    \class QSystemLocale::CurrencyToStringArgument
    \inmodule QtCore

    A helper class that provides arguments for the QSystemLocale::query()
    function with query type QSystemLocale::CurrencyToString.

    \sa QSystemLocale::QueryType
    \since 4.8
*/

/*!
    \fn QSystemLocale::CurrencyToStringArgument::CurrencyToStringArgument()
    \internal
*/
/*!
    \variable QSystemLocale::CurrencyToStringArgument::value

    An input value that should be converted to its string representation.
    Contains one of QVariant::LongLong, QVariant::ULongLong or QVariant::Double
    types.
*/
/*!
    \variable QSystemLocale::CurrencyToStringArgument::symbol

    An optional argument containing a currency symbol to be used in the
    currency string.
*/


/*!
\fn QString QLocale::toString(short i) const

\overload

\sa toShort()
*/

/*!
\fn QString QLocale::toString(ushort i) const

\overload

\sa toUShort()
*/

/*!
\fn QString QLocale::toString(int i) const

\overload

\sa toInt()
*/

/*!
\fn QString QLocale::toString(uint i) const

\overload

\sa toUInt()
*/

/*
\fn QString QLocale::toString(long i) const

\overload

\sa  toLong()
*/

/*
\fn QString QLocale::toString(ulong i) const

\overload

\sa toULong()
*/

/*!
\fn QString QLocale::toString(float i, char f = 'g', int prec = 6) const

\overload

\a f and \a prec have the same meaning as in QString::number(double, char, int).

\sa toDouble()
*/

/*!
    \fn QString QLocale::toCurrencyString(short value, const QString &symbol) const
    \since 4.8
    \overload
*/

/*!
    \fn QString QLocale::toCurrencyString(ushort value, const QString &symbol) const
    \since 4.8
    \overload
*/

/*!
    \fn QString QLocale::toCurrencyString(int value, const QString &symbol) const
    \since 4.8
    \overload
*/

/*!
    \fn QString QLocale::toCurrencyString(uint value, const QString &symbol) const
    \since 4.8
    \overload
*/
/*!
    \fn QString QLocale::toCurrencyString(float value, const QString &symbol) const
    \since 4.8
    \overload
*/