Revision control
++ // Copyright (C) 2021 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
++ // Qt-Security score:insignificant reason:docs
++
++ /*!
++ \class QLocale
++ \inmodule QtCore
++ \brief The QLocale class converts between numbers and their
++ string representations in various languages.
++
++ \compares equality
++ \reentrant
++ \ingroup i18n
++ \ingroup string-processing
++ \ingroup shared
++
++ QLocale is constructed for a specified language, optional script and
++ territory. It offers various facilities for formatting data as text,
++ localized appropriately, and for reading data out of localized text.
++
++ Example:
++
++ \snippet code/src_corelib_text_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::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_text_qlocale.cpp 1
++
++ An alternative method for constructing a QLocale object is by
++ specifying the locale name.
++
++ \snippet code/src_corelib_text_qlocale.cpp 2
++
++ This constructor reads the language, script and/or territory from the given
++ name, accepting either uderscore or dash as separator (and ignoring any
++ trailing \c{.codeset} or \c{@variant} suffix).
++
++ \note For the current keyboard input locale take a look at
++ QInputMethod::locale().
++
++ \section1 Appropriateness of the formats
++
++ QLocale's data is based on Common Locale Data Repository v48.2.
++
++ This data is published by The Unicode Consortium, who aim to follow
++ customary, common use by writers of each language, in each script, in each
++ territory for which data is given. This may in some cases differ from what
++ is recognized as official, depending on how widely that official standard is
++ followed in practice.
++
++ For example, although the relevant international standard (from the BIPM)
++ mandates a thin non-breaking space as the separator between groups of digits
++ in numbers, when they are split up to aid readability, and many
++ jurisdictions have adopted this as their official standard for the
++ formatting of numbers, many locales in fact have a traditional way of
++ formatting numbers with punctuators separating groups of digits. CLDR, and
++ thus QLocale, follows this common usage rather than the official standard.
++
++ \section1 Matching combinations of language, script and territory
++
++ QLocale has data, derived from CLDR, for many combinations of language,
++ script and territory, but not all. If it is constructed with all three of
++ these key values specified (treating \c AnyLanguage, \c AnyScript or \c
++ AnyTerritory as unspecified) and QLocale has data for the given combination,
++ this data is used. Otherwise, QLocale does its best to find a sensible
++ combination of language, script and territory, for which it does have data,
++ that matches those that were specified.
++
++ The CLDR provides tables of likely combinations, which are used to fill in
++ any unspecified key or keys; if QLocale has data for the result of such a
++ likely combination, that is used. If no language is specified, and none can
++ be determined from script and territory, or if QLocale has no data for the
++ language, the "C" locale (when reading the keys from a string) or default
++ locale (otherwise) is used.
++
++ When QLocale has no data for the keys specified, with likely keys filled in
++ where unspecified, but does have data for the resulting language, a
++ fall-back is sought, based on ignoring either territory, script or both (in
++ that order). This results in a QLocale which may not match what was asked
++ for, but provides localization that's as suitable as the available data
++ permits, for the keys specified.
++
++ Use language(), script() and territory() to determine the actual keys used.
++
++ \sa QString::arg(), QInputMethod::locale()
++ */
++
++ /*!
++ \enum QLocale::Language
++
++ This enumerated type is used to specify a language.
++
++ \value AnyLanguage
++ \value C A simplified English locale; see QLocale::c()
++
++ \value Abkhazian
++ \value Afan Obsolete, please use Oromo
++ \value Afar
++ \value Afrikaans
++ \value Aghem
++ \value Akan
++ \value [since 5.1] Akkadian
++ \value [since 5.3] Akoose
++ \value Albanian
++ \value [since 5.7] AmericanSignLanguage
++ \value Amharic
++ \value [since 5.1] AncientEgyptian
++ \value [since 5.1] AncientGreek
++ \value [since 6.7] Anii
++ \value Arabic
++ \value [since 5.1] Aragonese
++ \value [since 5.1] Aramaic
++ \value Armenian
++ \value Assamese
++ \value Asturian
++ \value Asu
++ \value Atsam
++ \value Avaric
++ \value Avestan
++ \value Aymara
++ \value Azerbaijani
++ \value Bafia
++ \value [since 5.1] Balinese
++ \value [since 6.6] Baluchi
++ \value Bambara
++ \value [since 5.1] Bamun
++ \value [since 6.0] Bangla
++ \value Basaa
++ \value Bashkir
++ \value Basque
++ \value [since 5.1] BatakToba
++ \value Belarusian
++ \value Bemba
++ \value Bena
++ \value Bengali Obsolete, please use Bangla
++ \value [since 5.7] Bhojpuri
++ \value Bhutani Obsolete, please use Dzongkha
++ \value Bislama
++ \value Blin
++ \value Bodo
++ \value Bosnian
++ \value Breton
++ \value [since 5.1] Buginese
++ \value Bulgarian
++ \value Burmese
++ \value Byelorussian Obsolete, please use Belarusian
++ \value Cambodian Obsolete, please use Khmer
++ \value [since 5.7] Cantonese
++ \value Catalan
++ \value [since 5.14] Cebuano
++ \value [since 6.0] CentralAtlasTamazight
++ \value [since 5.5] CentralKurdish
++ \value CentralMoroccoTamazight Obsolete, please use CentralAtlasTamazight
++ \value [since 5.1] Chakma
++ \value Chamorro
++ \value Chechen
++ \value Cherokee
++ \value Chewa Obsolete, please use Nyanja
++ \value [since 5.14] Chickasaw
++ \value Chiga
++ \value Chinese (Mandarin)
++ \value Church
++ \value Chuvash
++ \value Colognian
++ \value [since 5.1] Coptic
++ \value Cornish
++ \value Corsican
++ \value Cree
++ \value Croatian
++ \value Czech
++ \value Danish
++ \value Divehi
++ \value [since 5.1] Dogri
++ \value Duala
++ \value Dutch
++ \value Dzongkha
++ \value Embu
++ \value English
++ \value [since 5.14] Erzya
++ \value Esperanto
++ \value Estonian
++ \value Ewe
++ \value Ewondo
++ \value Faroese
++ \value Fijian
++ \value Filipino
++ \value Finnish
++ \value French
++ \value Frisian same as WesternFrisian
++ \value Friulian
++ \value Fulah
++ \value Ga
++ \value Gaelic
++ \value Galician
++ \value Ganda
++ \value Geez
++ \value Georgian
++ \value German
++ \value [since 5.1] Gothic
++ \value Greek
++ \value Greenlandic Obsolete, please use Kalaallisut
++ \value Guarani
++ \value Gujarati
++ \value Gusii
++ \value Haitian
++ \value [since 6.5] Haryanvi
++ \value Hausa
++ \value Hawaiian
++ \value Hebrew
++ \value Herero
++ \value Hindi
++ \value HiriMotu
++ \value Hungarian
++ \value Icelandic
++ \value [since 5.12] Ido
++ \value Igbo
++ \value [since 5.5] InariSami
++ \value Indonesian
++ \value [since 5.1] Ingush
++ \value Interlingua
++ \value Interlingue
++ \value Inuktitut
++ \value Inupiak Obsolete, please use Inupiaq
++ \value [since 6.0] Inupiaq
++ \value Irish
++ \value Italian
++ \value Japanese
++ \value Javanese
++ \value Jju
++ \value JolaFonyi
++ \value Kabuverdianu
++ \value Kabyle
++ \value [since 6.3] Kaingang
++ \value Kako
++ \value [since 6.0] Kalaallisut
++ \value Kalenjin
++ \value Kamba
++ \value [since 6.7] Kangri
++ \value Kannada
++ \value Kanuri
++ \value [since 6.9] KaraKalpak
++ \value Kashmiri
++ \value Kazakh
++ \value [since 5.5] Kenyang
++ \value Khmer
++ \value [since 5.5] Kiche
++ \value Kikuyu
++ \value Kinyarwanda
++ \value Kirghiz Obsolete, please use Kyrgyz
++ \value Komi
++ \value Kongo
++ \value Konkani
++ \value Korean
++ \value Koro
++ \value KoyraboroSenni
++ \value KoyraChiini
++ \value Kpelle
++ \value [since 6.0] Kuanyama
++ \value Kurdish
++ \value Kurundi Obsolete, please use Rundi
++ \value [since 6.8] Kuvi
++ \value Kwanyama Obsolete, please use Kuanyama
++ \value Kwasio
++ \value [since 6.0] Kyrgyz
++ \value [since 6.11] Ladin
++ \value [since 5.3] Lakota
++ \value Langi
++ \value Lao
++ \value Latin
++ \value Latvian
++ \value [since 5.5] Lezghian
++ \value Limburgish
++ \value Lingala
++ \value [since 6.6] Ligurian
++ \value [since 5.7] LiteraryChinese
++ \value Lithuanian
++ \value [since 5.12] Lojban
++ \value [since 5.5] LowerSorbian
++ \value LowGerman
++ \value LubaKatanga
++ \value [since 5.5] LuleSami
++ \value Luo
++ \value Luxembourgish
++ \value Luyia
++ \value Macedonian
++ \value Machame
++ \value [since 5.5] Maithili
++ \value MakhuwaMeetto
++ \value Makonde
++ \value Malagasy
++ \value Malay
++ \value Malayalam
++ \value Maltese
++ \value [since 5.1] Mandingo
++ \value [since 5.1] Manipuri
++ \value Manx
++ \value Maori
++ \value [since 5.5] Mapuche
++ \value Marathi
++ \value Marshallese
++ \value Masai
++ \value [since 5.7] Mazanderani
++ \value [since 5.5] Mende
++ \value Meru
++ \value Meta
++ \value [since 5.5] Mohawk
++ \value [since 6.5] Moksha
++ \value Mongolian
++ \value Morisyen
++ \value Mundang
++ \value [since 5.14] Muscogee
++ \value Nama
++ \value NauruLanguage
++ \value Navaho Obsolete, please use Navajo
++ \value [since 6.0] Navajo
++ \value Ndonga
++ \value Nepali
++ \value [since 5.7] Newari
++ \value Ngiemboon
++ \value [since 6.3] Nheengatu
++ \value [since 6.0] NigerianPidgin
++ \value Ngomba
++ \value [since 5.5] Nko
++ \value [since 6.5] NorthernFrisian
++ \value [since 5.7] NorthernLuri
++ \value NorthernSami
++ \value NorthernSotho
++ \value NorthNdebele
++ \value NorwegianBokmal
++ \value NorwegianNynorsk
++ \value Nuer
++ \value Nyanja
++ \value Nyankole
++ \value [since 6.5] Obolo
++ \value Occitan
++ \value [since 6.0] Odia
++ \value Ojibwa
++ \value [since 5.1] OldIrish
++ \value [since 5.1] OldNorse
++ \value [since 5.1] OldPersian
++ \value Oriya Obsolete, please use Odia
++ \value Oromo
++ \value [since 5.7] Osage
++ \value Ossetic
++ \value [since 5.1] Pahlavi
++ \value [since 5.7] Palauan
++ \value Pali
++ \value [since 5.7] Papiamento
++ \value Pashto
++ \value Persian
++ \value [since 5.1] Phoenician
++ \value [since 6.5] Pijin
++ \value Polish
++ \value Portuguese
++ \value [since 5.5] Prussian
++ \value Punjabi
++ \value Quechua
++ \value [since 6.5] Rajasthani
++ \value RhaetoRomance Obsolete, please use Romansh
++ \value [since 6.6] Rohingya
++ \value Romanian
++ \value Romansh
++ \value Rombo
++ \value Rundi
++ \value Russian
++ \value Rwa
++ \value Saho
++ \value Sakha
++ \value Samburu
++ \value Samoan
++ \value Sango
++ \value Sangu
++ \value Sanskrit
++ \value [since 5.1] Santali
++ \value Sardinian
++ \value [since 5.1] Saurashtra
++ \value Sena
++ \value Serbian
++ \value Shambala
++ \value [since 6.11] Shan
++ \value Shona
++ \value SichuanYi
++ \value [since 5.12] Sicilian
++ \value Sidamo
++ \value [since 5.14] Silesian
++ \value Sindhi
++ \value Sinhala
++ \value [since 5.5] SkoltSami
++ \value Slovak
++ \value Slovenian
++ \value Soga
++ \value Somali
++ \value [since 5.12] SouthernKurdish
++ \value [since 5.5] SouthernSami
++ \value SouthernSotho
++ \value SouthNdebele
++ \value Spanish
++ \value [since 5.3] StandardMoroccanTamazight
++ \value Sundanese
++ \value Swahili
++ \value [since 6.9] SwampyCree
++ \value Swati
++ \value Swedish
++ \value SwissGerman
++ \value Syriac
++ \value Tachelhit
++ \value Tahitian
++ \value [since 5.1] TaiDam
++ \value Taita
++ \value Tajik
++ \value Tamil
++ \value Taroko
++ \value Tasawaq
++ \value Tatar
++ \value Telugu
++ \value Teso
++ \value Thai
++ \value Tibetan
++ \value Tigre
++ \value Tigrinya
++ \value [since 5.7] TokelauLanguage
++ \value [since 6.5] TokiPona
++ \value [since 5.7] TokPisin
++ \value Tongan
++ \value [since 6.6] Torwali
++ \value Tsonga
++ \value Tswana
++ \value Turkish
++ \value Turkmen
++ \value [since 5.7] TuvaluLanguage
++ \value Tyap
++ \value [since 5.1] Ugaritic
++ \value Uighur Obsolete, please use Uyghur
++ \value Uigur Obsolete, please use Uyghur
++ \value Ukrainian
++ \value [since 5.5] UpperSorbian
++ \value Urdu
++ \value [since 6.0] Uyghur
++ \value Uzbek
++ \value Vai
++ \value Venda
++ \value [since 6.7] Venetian
++ \value Vietnamese
++ \value Volapuk
++ \value Vunjo
++ \value Walamo Obsolete, please use Wolaytta
++ \value Walloon
++ \value Walser
++ \value [since 5.5] Warlpiri
++ \value Welsh
++ \value [since 5.12] WesternBalochi
++ \value WesternFrisian same as Frisian
++ \value [since 6.0] Wolaytta
++ \value Wolof
++ \value Xhosa
++ \value Yangben
++ \value Yiddish
++ \value Yoruba
++ \value Zarma
++ \value Zhuang
++ \value Zulu
++
++ \omitvalue LastLanguage
++
++ \sa language(), languageToString()
++ */
++
++ /*!
++ \typealias QLocale::Territory
++
++ This enumeration type is an alias for \l Country,
++ which shall be renamed to Territory at a future release.
++
++ \sa territory(), territoryToString()
++ */
++
++ /*!
++ \enum QLocale::Country
++
++ This enumerated type is used to identify a territory.
++
++ An individual territory may be a province of a country, a country (by far the
++ most common case) or a larger geographic entity, to which some localization
++ details are specific.
++
++ \value AnyCountry Osbolete alias for \c AnyTerritory
++ \value [since 6.2] AnyTerritory
++
++ \value Afghanistan
++ \value AlandIslands
++ \value Albania
++ \value Algeria
++ \value AmericanSamoa
++ \value Andorra
++ \value Angola
++ \value Anguilla
++ \value Antarctica
++ \value AntiguaAndBarbuda
++ \value Argentina
++ \value Armenia
++ \value Aruba
++ \value AscensionIsland
++ \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 Bonaire
++ \value BosniaAndHerzegowina Obsolete, use \c BosniaAndHerzegovina instead
++ \value [since 6.0] BosniaAndHerzegovina
++ \value Botswana
++ \value BouvetIsland
++ \value Brazil
++ \value BritishIndianOceanTerritory
++ \value BritishVirginIslands
++ \value Brunei
++ \value Bulgaria
++ \value BurkinaFaso
++ \value Burundi
++ \value Cambodia
++ \value Cameroon
++ \value Canada
++ \value CanaryIslands
++ \value CaribbeanNetherlands
++ \value CapeVerde
++ \value CaymanIslands
++ \value CentralAfricanRepublic
++ \value CeutaAndMelilla
++ \value Chad
++ \value Chile
++ \value China
++ \value ChristmasIsland
++ \value ClippertonIsland
++ \value CocosIslands
++ \value Colombia
++ \value Comoros
++ \value CongoBrazzaville
++ \value CongoKinshasa
++ \value CookIslands
++ \value CostaRica
++ \value Croatia
++ \value Cuba
++ \value [since 6.0] Curacao
++ \value CuraSao Obsolete, use \c Curacao instead
++ \value Cyprus
++ \value [since 6.0] Czechia
++ \value CzechRepublic Obsolete, use \c Czechia instead
++ \value DemocraticRepublicOfCongo Obsolete, use \c CongoKinshasa instead
++ \value DemocraticRepublicOfKorea Obsolete, use \c NorthKorea instead
++ \value Denmark
++ \value DiegoGarcia
++ \value Djibouti
++ \value Dominica
++ \value DominicanRepublic
++ \value EastTimor
++ \value Ecuador
++ \value Egypt
++ \value ElSalvador
++ \value EquatorialGuinea
++ \value Eritrea
++ \value Estonia
++ \value Eswatini
++ \value Ethiopia
++ \value [since 5.7] EuropeanUnion
++ \value [since 5.12] Europe
++ \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 IsleOfMan
++ \value Israel
++ \value Italy
++ \value IvoryCoast
++ \value Jamaica
++ \value Japan
++ \value Jersey
++ \value Jordan
++ \value Kazakhstan
++ \value Kenya
++ \value Kiribati
++ \value [since 5.2] Kosovo
++ \value Kuwait
++ \value Kyrgyzstan
++ \value Laos
++ \value LatinAmerica
++ \value LatinAmericaAndTheCaribbean Obsolete, use \c LatinAmerica instead
++ \value Latvia
++ \value Lebanon
++ \value Lesotho
++ \value Liberia
++ \value Libya
++ \value Liechtenstein
++ \value Lithuania
++ \value Luxembourg
++ \value Macao
++ \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 Montenegro
++ \value Montserrat
++ \value Morocco
++ \value Mozambique
++ \value Myanmar
++ \value Namibia
++ \value NauruCountry Osbolete alias for \c NauruTerritory
++ \value [since 6.2] NauruTerritory
++ \value Nepal
++ \value Netherlands
++ \value NewCaledonia
++ \value NewZealand
++ \value Nicaragua
++ \value Niger
++ \value Nigeria
++ \value Niue
++ \value NorfolkIsland
++ \value NorthernMarianaIslands
++ \value NorthKorea
++ \value Norway
++ \value Oman
++ \value [since 5.7] OutlyingOceania
++ \value Pakistan
++ \value Palau
++ \value PalestinianTerritories
++ \value Panama
++ \value PapuaNewGuinea
++ \value Paraguay
++ \value PeoplesRepublicOfCongo Obsolete, use \c CongoBrazzaville instead
++ \value Peru
++ \value Philippines
++ \value Pitcairn
++ \value Poland
++ \value Portugal
++ \value PuertoRico
++ \value Qatar
++ \value RepublicOfKorea Obsolete, use \c SouthKorea instead
++ \value Reunion
++ \value Romania
++ \value RussianFederation
++ \value Russia
++ \value Rwanda
++ \value SaintBarthelemy
++ \value SaintHelena
++ \value SaintKittsAndNevis
++ \value SaintLucia
++ \value SaintMartin
++ \value SaintPierreAndMiquelon
++ \value SaintVincentAndGrenadines
++ \value SaintVincentAndTheGrenadines
++ \value Samoa
++ \value SanMarino
++ \value SaoTomeAndPrincipe
++ \value SaudiArabia
++ \value Senegal
++ \value Serbia
++ \value Seychelles
++ \value SierraLeone
++ \value Singapore
++ \value SintMaarten
++ \value Slovakia
++ \value Slovenia
++ \value SolomonIslands
++ \value Somalia
++ \value SouthAfrica
++ \value SouthGeorgiaAndSouthSandwichIslands
++ \value SouthGeorgiaAndTheSouthSandwichIslands
++ \value SouthKorea
++ \value SouthSudan
++ \value Spain
++ \value SriLanka
++ \value Sudan
++ \value Suriname
++ \value SvalbardAndJanMayen
++ \value SvalbardAndJanMayenIslands
++ \value Swaziland
++ \value Sweden
++ \value Switzerland
++ \value Syria
++ \value SyrianArabRepublic Obsolete, use \c Syria instead
++ \value Taiwan
++ \value Tajikistan
++ \value Tanzania
++ \value Thailand
++ \value TimorLeste
++ \value Togo
++ \value TokelauCountry Osbolete alias for \c TokelauTerritory
++ \value [since 6.2] TokelauTerritory
++ \value Tonga
++ \value TrinidadAndTobago
++ \value TristanDaCunha
++ \value Tunisia
++ \value Turkey
++ \value Turkmenistan
++ \value TurksAndCaicosIslands
++ \value TuvaluCountry Osbolete alias for \c TuvaluTerritory
++ \value [since 6.2] TuvaluTerritory
++ \value Uganda
++ \value Ukraine
++ \value UnitedArabEmirates
++ \value UnitedKingdom
++ \value UnitedStates
++ \value UnitedStatesOutlyingIslands
++ \value UnitedStatesMinorOutlyingIslands
++ \value UnitedStatesVirginIslands
++ \value Uruguay
++ \value Uzbekistan
++ \value Vanuatu
++ \value VaticanCity
++ \value VaticanCityState
++ \value Venezuela
++ \value Vietnam
++ \value WallisAndFutuna
++ \value WallisAndFutunaIslands
++ \value WesternSahara
++ \value [since 5.12] World
++ \value Yemen
++ \value Zambia
++ \value Zimbabwe
++
++ \omitvalue LastCountry Osbolete alias for \c LastTerritory
++ \omitvalue LastTerritory
++
++ \note Use the Territory alias for this enumeration where possible.
++ The Country enum shall be renamed to Territory at a later release.
++
++ \sa territory(), territoryToString(), codeToTerritory(), territoryToCode()
++ */
++
++ /*!
++ \enum QLocale::Script
++
++ This enumerated type is used to specify a script.
++
++ \value AnyScript
++
++ \value [since 5.7] AdlamScript
++ \value [since 5.7] AhomScript
++ \value [since 5.7] AnatolianHieroglyphsScript
++ \value ArabicScript
++ \value ArmenianScript
++ \value [since 5.1] AvestanScript
++ \value [since 5.1] BalineseScript
++ \value [since 5.1] BamumScript
++ \value [since 6.0] BanglaScript
++ \value [since 5.5] BassaVahScript
++ \value [since 5.1] BatakScript
++ \value BengaliScript Obsolete, please use BanglaScript
++ \value [since 5.7] BhaiksukiScript
++ \value [since 5.1] BopomofoScript
++ \value [since 5.1] BrahmiScript
++ \value [since 5.1] BrailleScript
++ \value [since 5.1] BugineseScript
++ \value [since 5.1] BuhidScript
++ \value [since 5.1] CanadianAboriginalScript
++ \value [since 5.1] CarianScript
++ \value [since 5.5] CaucasianAlbanianScript
++ \value [since 5.1] ChakmaScript
++ \value [since 5.1] ChamScript
++ \value CherokeeScript
++ \value [since 5.1] CopticScript
++ \value [since 5.1] CuneiformScript
++ \value [since 5.1] CypriotScript
++ \value CyrillicScript
++ \value [since 5.1] DeseretScript
++ \value DevanagariScript
++ \value [since 5.5] DuployanScript
++ \value [since 5.1] EgyptianHieroglyphsScript
++ \value [since 5.5] ElbasanScript
++ \value EthiopicScript
++ \value [since 5.1] FraserScript
++ \value GeorgianScript
++ \value [since 5.1] GlagoliticScript
++ \value [since 5.1] GothicScript
++ \value [since 5.5] GranthaScript
++ \value GreekScript
++ \value GujaratiScript
++ \value GurmukhiScript
++ \value [since 5.1] HangulScript
++ \value [since 6.6] HanifiScript
++ \value [since 5.1] HanScript
++ \value [since 5.1] HanunooScript
++ \value [since 5.7] HanWithBopomofoScript
++ \value [since 5.7] HatranScript
++ \value HebrewScript
++ \value [since 5.1] HiraganaScript
++ \value [since 5.1] ImperialAramaicScript
++ \value [since 5.1] InscriptionalPahlaviScript
++ \value [since 5.1] InscriptionalParthianScript
++ \value [since 5.7] JamoScript
++ \value JapaneseScript
++ \value [since 5.1] JavaneseScript
++ \value [since 5.1] KaithiScript
++ \value KannadaScript
++ \value [since 5.1] KatakanaScript
++ \value [since 5.1] KayahLiScript
++ \value [since 5.1] KharoshthiScript
++ \value [since 5.1] KhmerScript
++ \value [since 5.5] KhojkiScript
++ \value [since 5.5] KhudawadiScript
++ \value KoreanScript
++ \value [since 5.1] LannaScript
++ \value LaoScript
++ \value LatinScript
++ \value [since 5.1] LepchaScript
++ \value [since 5.1] LimbuScript
++ \value [since 5.5] LinearAScript
++ \value [since 5.1] LinearBScript
++ \value [since 5.1] LycianScript
++ \value [since 5.1] LydianScript
++ \value [since 5.5] MahajaniScript
++ \value MalayalamScript
++ \value [since 5.1] MandaeanScript
++ \value [since 5.5] ManichaeanScript
++ \value [since 5.7] MarchenScript
++ \value [since 5.1] MeiteiMayekScript
++ \value [since 6.0] MendeScript
++ \value MendeKikakuiScript Obsolete, please use MendeScript
++ \value [since 5.1] MeroiticCursiveScript
++ \value [since 5.1] MeroiticScript
++ \value [since 5.5] ModiScript
++ \value MongolianScript
++ \value [since 5.5] MroScript
++ \value [since 5.7] MultaniScript
++ \value MyanmarScript
++ \value [since 5.5] NabataeanScript
++ \value [since 5.7] NewaScript
++ \value [since 5.1] NewTaiLueScript
++ \value [since 5.1] NkoScript
++ \value [since 5.1] OghamScript
++ \value [since 5.1] OlChikiScript
++ \value [since 5.7] OldHungarianScript
++ \value [since 5.1] OldItalicScript
++ \value [since 5.5] OldNorthArabianScript
++ \value [since 5.5] OldPermicScript
++ \value [since 5.1] OldPersianScript
++ \value [since 5.1] OldSouthArabianScript
++ \value [since 6.0] OdiaScript
++ \value OriyaScript Obsolete, please use OdiaScript
++ \value [since 5.1] OrkhonScript
++ \value [since 5.7] OsageScript
++ \value [since 5.1] OsmanyaScript
++ \value [since 5.5] PahawhHmongScript
++ \value [since 5.5] PalmyreneScript
++ \value [since 5.5] PauCinHauScript
++ \value [since 5.1] PhagsPaScript
++ \value [since 5.1] PhoenicianScript
++ \value [since 5.1] PollardPhoneticScript
++ \value [since 5.5] PsalterPahlaviScript
++ \value [since 5.1] RejangScript
++ \value [since 5.1] RunicScript
++ \value [since 5.1] SamaritanScript
++ \value [since 5.1] SaurashtraScript
++ \value [since 5.1] SharadaScript
++ \value [since 5.1] ShavianScript
++ \value [since 5.5] SiddhamScript
++ \value [since 5.7] SignWritingScript
++ \value SimplifiedChineseScript same as SimplifiedHanScript
++ \value SimplifiedHanScript same as SimplifiedChineseScript
++ \value SinhalaScript
++ \value [since 5.1] SoraSompengScript
++ \value [since 5.1] SundaneseScript
++ \value [since 5.1] SylotiNagriScript
++ \value SyriacScript
++ \value [since 5.1] TagalogScript
++ \value [since 5.1] TagbanwaScript
++ \value [since 5.1] TaiLeScript
++ \value [since 5.1] TaiVietScript
++ \value [since 5.1] TakriScript
++ \value TamilScript
++ \value [since 5.7] TangutScript
++ \value TeluguScript
++ \value ThaanaScript
++ \value ThaiScript
++ \value TibetanScript
++ \value TifinaghScript
++ \value [since 5.5] TirhutaScript
++ \value TraditionalChineseScript same as TraditionalHanScript
++ \value TraditionalHanScript same as TraditionalChineseScript
++ \value [since 5.1] UgariticScript
++ \value VaiScript
++ \value [since 5.5] VarangKshitiScript
++ \value YiScript
++
++ \omitvalue LastScript
++
++ \sa script(), scriptToString(), languageToString()
++ */
++
++ /*!
++ \enum QLocale::FormatType
++
++ This enum describes the different formats that can be used when
++ converting QDate, QTime, and QDateTime objects, as well
++ as months and days, to strings specific to the locale.
++
++ \value LongFormat Longer format.
++
++ \value ShortFormat Shorter format.
++
++ \value NarrowFormat A special version for use when space is very limited.
++
++ \note \c NarrowFormat might contain the same text for
++ different months and days. 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 \c ShortFormat.
++
++ \sa dateFormat(), timeFormat(), dateTimeFormat()
++ \sa monthName(), standaloneMonthName(), dayName(), standaloneDayName()
++ \sa toDate(), toTime(), toDateTime()
++ */
++
++ /*!
++ \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 for
++ all locales except the C locale, with group separators, with one
++ leading zero in single digit exponents, and without trailing zeroes
++ at the end of the fractional part (when present).
++ \value OmitGroupSeparator If this option is set, the number-to-string
++ functions will not break up digits into groups. The C locale sets
++ this option by default. The default for all other locales is to
++ break up digits into groups, in the whole-number part of a number,
++ with 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. The default is to
++ omit trailing zeroes, which may leave fewer digits in the fractional
++ part than the precision asked for.
++ \value RejectTrailingZeroesAfterDot If this option is set, the
++ string-to-number functions will fail if they encounter trailing
++ zeroes at the end of the fractional part, when parsing a number in
++ scientific or decimal representation. The default is to accept
++ trailing zeroes.
++
++ \sa setNumberOptions(), numberOptions(), FloatingPointPrecisionOption
++ */
++
++ /*!
++ \enum QLocale::FloatingPointPrecisionOption
++
++ This enum defines a constant 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. In particular, trailing zeros are
++ omitted (from the mantissa, in exponent formats).
++
++ \sa toString(), QString::number(), QByteArray::number()
++ \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, based on \l
++ {https://www.bipm.org/en/measurement-units} {SI}.
++ \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
++ */
++
++ /*!
++ \enum QLocale::LanguageCodeType
++
++ This enum defines language code types that can be used to restrict set
++ of language codes considered by \c codeToLanguage and \c languageToCode.
++
++ \value ISO639Part1 ISO 639 Part 1 Alpha 2 code.
++ \value ISO639Part2B ISO 639 Part 2 bibliographic Alpha 3 code.
++ \value ISO639Part2T ISO 639 Part 2 terminological Alpha 3 code.
++ \value ISO639Part3 ISO 639 Part 3 Alpha 3 code.
++ \value LegacyLanguageCode Codes that are not part of the above set, but that
++ were supported by Qt in the past. This value can only be used by
++ codeToLanguage(). It is ignored when passed to languageToCode().
++ \value ISO639Part2 Any ISO 639 Part 2 code.
++ \value ISO639Alpha2 Any ISO-639 2-letter code.
++ \value ISO639Alpha3 Any ISO-639 3-letter code.
++ \value ISO639 Any ISO 639 code.
++ \value AnyLanguageCode Specifies that any code can be used.
++ */
++
++ /*!
++ \fn bool QLocale::operator==(const QLocale &lhs, const QLocale &rhs)
++
++ Returns \c true if the two QLocale objects, \a lhs and \a rhs, are the same;
++ otherwise returns \c false.
++
++ \note The system locale is not equal to the QLocale object constructed from
++ its language(), script() and territory(), even if the two agree in all data
++ fields. Nor are two locales with different number options equal.
++
++ \sa operator!=(), setNumberOptions()
++ */
++
++ /*!
++ \fn bool QLocale::operator!=(const QLocale &lhs, const QLocale &rhs)
++
++ Returns \c true if the two QLocale objects, \a lhs and \a rhs, differ;
++ otherwise returns \c false.
++
++ \note The system locale is not equal to the QLocale object constructed from
++ its language(), script() and territory(), even if the two agree in all data
++ fields. Nor are two locales with different number options equal.
++
++ \sa operator==(), setNumberOptions()
++ */
++
++ /*!
++ \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 TerritoryId a uint specifying the territory.
++ \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 specifying 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 NativeTerritoryName a string that represents the name of the native territory.
++
++ \sa FormatType
++ */
++
++ /*!
++ \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
++ */
++
++ /*!
++ \fn QLocale QSystemLocale::fallbackLocale() const
++
++ \since 4.6
++
++ Returns the locale used if the system locale is not able to answer a query.
++
++ Must be a QLocale instance based on the built-in CLDR data, and should
++ match what the system locale is using as closely as that data supports.
++ */
++
++ /*!
++ \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 QMetaType::LongLong, QMetaType::ULongLong or QMetaType::Double
++ types.
++ */
++ /*!
++ \variable QSystemLocale::CurrencyToStringArgument::symbol
++
++ An optional argument containing a currency symbol to be used in the
++ currency string.
++ */
++
++ /*!
++ \fn QString QLocale::toString(long i) const
++
++ \overload
++
++ \sa toLong()
++ */
++
++ /*!
++ \fn QString QLocale::toString(ulong i) const
++
++ \overload
++
++ \sa toULong()
++ */
++
++ /*!
++ \fn QString QLocale::toString(ushort i) const
++
++ \overload
++
++ \sa toUShort()
++ */
++
++
++ /*!
++ \fn QString QLocale::toString(short i) const
++
++ \overload
++
++ \sa toShort()
++ */
++
++ /*!
++ \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 f, char format = 'g', int precision = 6) const
++ \overload
++
++ Returns a string representing the floating-point number \a f.
++
++ The \a format and \a precision have the same meanings as described in \l
++ {toString(double, char, int)}.
++
++ \sa toFloat(), toDouble(), numberOptions(), exponential(), decimalPoint(), zeroDigit(),
++ positiveSign(), percent(), toCurrencyString(), formattedDataSize(),
++ QLocale::FloatingPointPrecisionOption
++ */
++
++ /*!
++ \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
++ */