1/****************************************************************************
2**
3** Copyright (C) 2019 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the documentation of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:FDL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Free Documentation License Usage
18** Alternatively, this file may be used under the terms of the GNU Free
19** Documentation License version 1.3 as published by the Free Software
20** Foundation and appearing in the file included in the packaging of
21** this file. Please review the following information to ensure
22** the GNU Free Documentation License version 1.3 requirements
23** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
24** $QT_END_LICENSE$
25**
26****************************************************************************/
27
28/*!
29    \class QLocale
30    \inmodule QtCore
31    \brief The QLocale class converts between numbers and their
32    string representations in various languages.
33
34    \reentrant
35    \ingroup i18n
36    \ingroup string-processing
37    \ingroup shared
38
39
40    QLocale is initialized with a language/country pair in its
41    constructor and offers number-to-string and string-to-number
42    conversion functions similar to those in QString.
43
44    Example:
45
46    \snippet code/src_corelib_tools_qlocale.cpp 0
47
48    QLocale supports the concept of a default locale, which is
49    determined from the system's locale settings at application
50    startup. The default locale can be changed by calling the
51    static member setDefault(). Setting the default locale has the
52    following effects:
53
54    \list
55    \li If a QLocale object is constructed with the default constructor,
56       it will use the default locale's settings.
57    \li QString::toInt(), QString::toDouble(), etc., interpret the
58       string according to the default locale. If this fails, it
59       falls back on the "C" locale.
60    \li QString::arg() uses the default locale to format a number when
61       its position specifier in the format string contains an 'L',
62       e.g. "%L1".
63    \endlist
64
65    The following example illustrates how to use QLocale directly:
66
67    \snippet code/src_corelib_tools_qlocale.cpp 1
68
69    When a language/country pair is specified in the constructor, one
70    of three things can happen:
71
72    \list
73    \li If the language/country pair is found in the database, it is used.
74    \li If the language is found but the country is not, or if the country
75       is \c AnyCountry, the language is used with the most
76       appropriate available country (for example, Germany for German),
77    \li If neither the language nor the country are found, QLocale
78       defaults to the default locale (see setDefault()).
79    \endlist
80
81    Use language() and country() to determine the actual language and
82    country values used.
83
84    An alternative method for constructing a QLocale object is by
85    specifying the locale name.
86
87    \snippet code/src_corelib_tools_qlocale.cpp 2
88
89    This constructor converts the locale name to a language/country
90    pair; it does not use the system locale database.
91
92    \note For the current keyboard input locale take a look at
93    QInputMethod::locale().
94
95    QLocale's data is based on Common Locale Data Repository v38.
96
97    \sa QString::arg(), QString::toInt(), QString::toDouble(),
98    QInputMethod::locale()
99*/
100
101/*!
102    \enum QLocale::Language
103
104    This enumerated type is used to specify a language.
105
106    \value AnyLanguage
107    \value C A simplified English locale; see QLocale::c()
108
109    \value Abkhazian
110    \value Afan Obsolete, please use Oromo
111    \value Afar
112    \value Afrikaans
113    \value Aghem
114    \value Ahom Obsolete, no locale data available
115    \value Akan
116    \value Akkadian Since Qt 5.1
117    \value Akoose Since Qt 5.3
118    \value Albanian
119    \value AmericanSignLanguage Since Qt 5.7
120    \value Amharic
121    \value AncientEgyptian Since Qt 5.1
122    \value AncientGreek Since Qt 5.1
123    \value AncientNorthArabian Obsolete, no locale data available
124    \value Arabic
125    \value Aragonese Since Qt 5.1
126    \value Aramaic Since Qt 5.1
127    \value ArdhamagadhiPrakrit Obsolete, no locale data available
128    \value Armenian
129    \value Assamese
130    \value Asturian
131    \value Asu
132    \value Atsam
133    \value Avaric
134    \value Avestan
135    \value Aymara
136    \value Azerbaijani
137    \value Bafia
138    \value Balinese Since Qt 5.1
139    \value Bambara
140    \value Bamun Since Qt 5.1
141    \value Basaa
142    \value Bashkir
143    \value Basque
144    \value Bassa Obsolete, no locale data available
145    \value BatakToba Since Qt 5.1
146    \value Belarusian
147    \value Bemba
148    \value Bena
149    \value Bengali
150    \value Bhojpuri Since Qt 5.7
151    \value Bhutani Obsolete, please use Dzongkha
152    \value Bihari Obsolete, no locale data available
153    \value Bislama
154    \value Blin
155    \value Bodo
156    \value Bosnian
157    \value Breton
158    \value Buginese Since Qt 5.1
159    \value Buhid Obsolete, no locale data available
160    \value Bulgarian
161    \value Burmese
162    \value Byelorussian Obsolete, please use Belarusian
163    \value Cambodian Obsolete, please use Khmer
164    \value Cantonese Since Qt 5.7
165    \value Carian Obsolete, no locale data available
166    \value Catalan
167    \value Cebuano Since Qt 5.14
168    \value CentralKurdish Since Qt 5.5
169    \value CentralMoroccoTamazight
170    \value Chakma Since Qt 5.1
171    \value Chamorro
172    \value Chechen
173    \value Cherokee
174    \value Chewa Obsolete, please use Nyanja
175    \value Chickasaw Since Qt 5.14
176    \value Chiga
177    \value Chinese (Mandarin)
178    \value Church
179    \value Chuvash
180    \value ClassicalMandaic Obsolete, no locale data available
181    \value Colognian
182    \value CongoSwahili Obsolete, no locale data available
183    \value Coptic Since Qt 5.1
184    \value Cornish
185    \value Corsican
186    \value Cree
187    \value Croatian
188    \value Czech
189    \value Danish
190    \value Divehi
191    \value Dogri Since Qt 5.1
192    \value Duala
193    \value Dutch
194    \value Dzongkha
195    \value EasternCham Obsolete, no locale data available
196    \value EasternKayah Obsolete, no locale data available
197    \value Embu
198    \value English
199    \value Erzya Since Qt 5.14
200    \value Esperanto
201    \value Estonian
202    \value Etruscan Obsolete, no locale data available
203    \value Ewe
204    \value Ewondo
205    \value Faroese
206    \value Fijian
207    \value Filipino
208    \value Finnish
209    \value French
210    \value Frisian same as WesternFrisian
211    \value Friulian
212    \value Fulah
213    \value Ga
214    \value Gaelic
215    \value Galician
216    \value Ganda
217    \value Geez
218    \value Georgian
219    \value German
220    \value Gothic Since Qt 5.1
221    \value Greek
222    \value Greenlandic
223    \value Guarani
224    \value Gujarati
225    \value Gusii
226    \value Haitian
227    \value Hanunoo Obsolete, no locale data available
228    \value Hausa
229    \value Hawaiian
230    \value Hebrew
231    \value Herero
232    \value HieroglyphicLuwian Obsolete, no locale data available
233    \value Hindi
234    \value HiriMotu
235    \value HmongNjua Obsolete, no locale data available
236    \value Ho Obsolete, no locale data available
237    \value Hungarian
238    \value Icelandic
239    \value Ido Since Qt 5.12
240    \value Igbo
241    \value InariSami Since Qt 5.5
242    \value Indonesian
243    \value Ingush Since Qt 5.1
244    \value Interlingua
245    \value Interlingue
246    \value Inuktitut
247    \value Inupiak
248    \value Irish
249    \value Italian
250    \value Japanese
251    \value Javanese
252    \value Jju
253    \value JolaFonyi
254    \value Kabuverdianu
255    \value Kabyle
256    \value Kako
257    \value Kalenjin
258    \value Kamba
259    \value Kannada
260    \value Kanuri
261    \value Kashmiri
262    \value Kazakh
263    \value Kenyang Since Qt 5.5
264    \value Khmer
265    \value Kiche Since Qt 5.5
266    \value Kikuyu
267    \value Kinyarwanda
268    \value Kirghiz
269    \value Komi
270    \value Kongo
271    \value Konkani
272    \value Korean
273    \value Koro
274    \value KoyraboroSenni
275    \value KoyraChiini
276    \value Kpelle
277    \value Kurdish
278    \value Kurundi Obsolete, please use Rundi
279    \value Kwanyama
280    \value Kwasio
281    \value Lakota Since Qt 5.3
282    \value Langi
283    \value Lao
284    \value LargeFloweryMiao Obsolete, no locale data available
285    \value Latin
286    \value Latvian
287    \value Lepcha Obsolete, no locale data available
288    \value Lezghian Since Qt 5.5
289    \value Limburgish
290    \value Limbu Obsolete, no locale data available
291    \value LinearA Obsolete, no locale data available
292    \value Lingala
293    \value Lisu Obsolete, no locale data available
294    \value LiteraryChinese Since Qt 5.7
295    \value Lithuanian
296    \value Lojban Since Qt 5.12
297    \value LowerSorbian Since Qt 5.5
298    \value LowGerman
299    \value LubaKatanga
300    \value LuleSami Since Qt 5.5
301    \value Luo
302    \value Lu Obsolete, no locale data available
303    \value Luxembourgish
304    \value Luyia
305    \value Lycian Obsolete, no locale data available
306    \value Lydian Obsolete, no locale data available
307    \value Macedonian
308    \value Machame
309    \value Maithili Since Qt 5.5
310    \value MakhuwaMeetto
311    \value Makonde
312    \value Malagasy
313    \value Malay
314    \value Malayalam
315    \value Maltese
316    \value Mandingo Since Qt 5.1
317    \value ManichaeanMiddlePersian Obsolete, no locale data available
318    \value Manipuri Since Qt 5.1
319    \value Manx
320    \value Maori
321    \value Mapuche Since Qt 5.5
322    \value Marathi
323    \value Marshallese
324    \value Masai
325    \value Mazanderani Since Qt 5.7
326    \value Mende Since Qt 5.5
327    \value Meroitic Obsolete, no locale data available
328    \value Meru
329    \value Meta
330    \value Mohawk Since Qt 5.5
331    \value Moldavian Obsolete, please use Romanian
332    \value Mongolian
333    \value Mono Obsolete, no locale data available
334    \value Morisyen
335    \value Mru Obsolete, no locale data available
336    \value Mundang
337    \value Muscogee Since Qt 5.14
338    \value Nama
339    \value NauruLanguage
340    \value Navaho
341    \value Ndonga
342    \value Nepali
343    \value Newari Since Qt 5.7
344    \value Ngiemboon
345    \value Ngomba
346    \value Nko Since Qt 5.5
347    \value NorthernLuri Since Qt 5.7
348    \value NorthernSami
349    \value NorthernSotho
350    \value NorthernThai Obsolete, no locale data available
351    \value NorthNdebele
352    \value NorwegianBokmal
353    \value NorwegianNynorsk
354    \value Norwegian Obsolete, please use NorwegianBokmal
355    \value Nuer
356    \value Nyanja
357    \value Nyankole
358    \value Occitan
359    \value Ojibwa
360    \value OldIrish Since Qt 5.1
361    \value OldNorse Since Qt 5.1
362    \value OldPersian Since Qt 5.1
363    \value OldTurkish Obsolete, no locale data available
364    \value Oriya
365    \value Oromo
366    \value Osage Since Qt 5.7
367    \value Ossetic
368    \value Pahlavi Since Qt 5.1
369    \value Palauan Since Qt 5.7
370    \value Pali
371    \value Papiamento Since Qt 5.7
372    \value Parthian Obsolete, no locale data available
373    \value Pashto
374    \value Persian
375    \value Phoenician Since Qt 5.1
376    \value Polish
377    \value Portuguese
378    \value PrakritLanguage Obsolete, no locale data available
379    \value Prussian Since Qt 5.5
380    \value Punjabi
381    \value Quechua
382    \value Rejang Obsolete, no locale data available
383    \value RhaetoRomance Obsolete, please use Romansh
384    \value Romanian
385    \value Romansh
386    \value Rombo
387    \value Rundi
388    \value Russian
389    \value Rwa
390    \value Sabaean Obsolete, no locale data available
391    \value Saho
392    \value Sakha
393    \value Samaritan Obsolete, no locale data available
394    \value Samburu
395    \value Samoan
396    \value Sango
397    \value Sangu
398    \value Sanskrit
399    \value Santali Since Qt 5.1
400    \value Saraiki Obsolete, no locale data available
401    \value Sardinian
402    \value Saurashtra Since Qt 5.1
403    \value Sena
404    \value Serbian
405    \value SerboCroatian Obsolete, please use Serbian
406    \value Shambala
407    \value Shona
408    \value SichuanYi
409    \value Sicilian Since Qt 5.12
410    \value Sidamo
411    \value Silesian Since Qt 5.14
412    \value Sindhi
413    \value Sinhala
414    \value SkoltSami Since Qt 5.5
415    \value Slovak
416    \value Slovenian
417    \value Soga
418    \value Somali
419    \value Sora Obsolete, no locale data available
420    \value SouthernKurdish Since Qt 5.12
421    \value SouthernSami Since Qt 5.5
422    \value SouthernSotho
423    \value SouthNdebele
424    \value Spanish
425    \value StandardMoroccanTamazight Since Qt 5.3
426    \value Sundanese
427    \value Swahili
428    \value Swati
429    \value Swedish
430    \value SwissGerman
431    \value Sylheti Obsolete, no locale data available
432    \value Syriac
433    \value Tachelhit
434    \value Tagalog Obsolete, please use Filipino
435    \value Tagbanwa Obsolete, no locale data available
436    \value Tahitian
437    \value TaiDam Since Qt 5.1
438    \value TaiNua Obsolete, no locale data available
439    \value Taita
440    \value Tajik
441    \value Tamil
442    \value Tangut Obsolete, no locale data available
443    \value Taroko
444    \value Tasawaq
445    \value Tatar
446    \value TedimChin Obsolete, no locale data available
447    \value Telugu
448    \value Teso
449    \value Thai
450    \value Tibetan
451    \value Tigre
452    \value Tigrinya
453    \value TokelauLanguage Since Qt 5.7
454    \value TokPisin Since Qt 5.7
455    \value Tongan
456    \value Tsonga
457    \value Tswana
458    \value Turkish
459    \value Turkmen
460    \value TuvaluLanguage Since Qt 5.7
461    \value Twi Obsolete, please use Akan
462    \value Tyap
463    \value Ugaritic Since Qt 5.1
464    \value Uighur
465    \value Uigur Obsolete, please use Uighur
466    \value Ukrainian
467    \value UncodedLanguages Obsolete, no locale data available
468    \value UpperSorbian Since Qt 5.5
469    \value Urdu
470    \value Uzbek
471    \value Vai
472    \value Venda
473    \value Vietnamese
474    \value Volapuk
475    \value Vunjo
476    \value Walamo
477    \value Walloon
478    \value Walser
479    \value Warlpiri Since Qt 5.5
480    \value Welsh
481    \value WesternBalochi Since Qt 5.12
482    \value WesternFrisian same as Frisian
483    \value Wolof
484    \value Xhosa
485    \value Yangben
486    \value Yiddish
487    \value Yoruba
488    \value Zarma
489    \value Zhuang
490    \value Zulu
491
492    \omitvalue LastLanguage
493
494    \sa language(), languageToString()
495*/
496
497/*!
498    \enum QLocale::Country
499
500    This enumerated type is used to specify a country.
501
502    \value AnyCountry
503
504    \value Afghanistan
505    \value AlandIslands
506    \value Albania
507    \value Algeria
508    \value AmericanSamoa
509    \value Andorra
510    \value Angola
511    \value Anguilla
512    \value Antarctica
513    \value AntiguaAndBarbuda
514    \value Argentina
515    \value Armenia
516    \value Aruba
517    \value AscensionIsland
518    \value Australia
519    \value Austria
520    \value Azerbaijan
521    \value Bahamas
522    \value Bahrain
523    \value Bangladesh
524    \value Barbados
525    \value Belarus
526    \value Belgium
527    \value Belize
528    \value Benin
529    \value Bermuda
530    \value Bhutan
531    \value Bolivia
532    \value Bonaire
533    \value BosniaAndHerzegowina
534    \value Botswana
535    \value BouvetIsland
536    \value Brazil
537    \value BritishIndianOceanTerritory
538    \value BritishVirginIslands
539    \value Brunei
540    \value Bulgaria
541    \value BurkinaFaso
542    \value Burundi
543    \value Cambodia
544    \value Cameroon
545    \value Canada
546    \value CanaryIslands
547    \value CapeVerde
548    \value CaymanIslands
549    \value CentralAfricanRepublic
550    \value CeutaAndMelilla
551    \value Chad
552    \value Chile
553    \value China
554    \value ChristmasIsland
555    \value ClippertonIsland
556    \value CocosIslands
557    \value Colombia
558    \value Comoros
559    \value CongoBrazzaville
560    \value CongoKinshasa
561    \value CookIslands
562    \value CostaRica
563    \value Croatia
564    \value Cuba
565    \value CuraSao
566    \value Cyprus
567    \value CzechRepublic
568    \value DemocraticRepublicOfCongo Obsolete, please use CongoKinshasa
569    \value DemocraticRepublicOfKorea Obsolete, please use NorthKorea
570    \value Denmark
571    \value DiegoGarcia
572    \value Djibouti
573    \value Dominica
574    \value DominicanRepublic
575    \value EastTimor
576    \value Ecuador
577    \value Egypt
578    \value ElSalvador
579    \value EquatorialGuinea
580    \value Eritrea
581    \value Estonia
582    \value Ethiopia
583    \value EuropeanUnion Since Qt 5.7
584    \value Europe Since Qt 5.12
585    \value FalklandIslands
586    \value FaroeIslands
587    \value Fiji
588    \value Finland
589    \value France
590    \value FrenchGuiana
591    \value FrenchPolynesia
592    \value FrenchSouthernTerritories
593    \value Gabon
594    \value Gambia
595    \value Georgia
596    \value Germany
597    \value Ghana
598    \value Gibraltar
599    \value Greece
600    \value Greenland
601    \value Grenada
602    \value Guadeloupe
603    \value Guam
604    \value Guatemala
605    \value Guernsey
606    \value Guinea
607    \value GuineaBissau
608    \value Guyana
609    \value Haiti
610    \value HeardAndMcDonaldIslands
611    \value Honduras
612    \value HongKong
613    \value Hungary
614    \value Iceland
615    \value India
616    \value Indonesia
617    \value Iran
618    \value Iraq
619    \value Ireland
620    \value IsleOfMan
621    \value Israel
622    \value Italy
623    \value IvoryCoast
624    \value Jamaica
625    \value Japan
626    \value Jersey
627    \value Jordan
628    \value Kazakhstan
629    \value Kenya
630    \value Kiribati
631    \value Kosovo Since Qt 5.2
632    \value Kuwait
633    \value Kyrgyzstan
634    \value Laos
635    \value LatinAmerica
636    \value LatinAmericaAndTheCaribbean Obsolete, please use LatinAmerica
637    \value Latvia
638    \value Lebanon
639    \value Lesotho
640    \value Liberia
641    \value Libya
642    \value Liechtenstein
643    \value Lithuania
644    \value Luxembourg
645    \value Macau
646    \value Macedonia
647    \value Madagascar
648    \value Malawi
649    \value Malaysia
650    \value Maldives
651    \value Mali
652    \value Malta
653    \value MarshallIslands
654    \value Martinique
655    \value Mauritania
656    \value Mauritius
657    \value Mayotte
658    \value Mexico
659    \value Micronesia
660    \value Moldova
661    \value Monaco
662    \value Mongolia
663    \value Montenegro
664    \value Montserrat
665    \value Morocco
666    \value Mozambique
667    \value Myanmar
668    \value Namibia
669    \value NauruCountry
670    \value Nepal
671    \value Netherlands
672    \value NewCaledonia
673    \value NewZealand
674    \value Nicaragua
675    \value Niger
676    \value Nigeria
677    \value Niue
678    \value NorfolkIsland
679    \value NorthernMarianaIslands
680    \value NorthKorea
681    \value Norway
682    \value Oman
683    \value OutlyingOceania Since Qt 5.7
684    \value Pakistan
685    \value Palau
686    \value PalestinianTerritories
687    \value Panama
688    \value PapuaNewGuinea
689    \value Paraguay
690    \value PeoplesRepublicOfCongo Obsolete, please use CongoBrazzaville
691    \value Peru
692    \value Philippines
693    \value Pitcairn
694    \value Poland
695    \value Portugal
696    \value PuertoRico
697    \value Qatar
698    \value RepublicOfKorea Obsolete, please use SouthKorea
699    \value Reunion
700    \value Romania
701    \value RussianFederation same as Russia
702    \value Russia same as RussianFederation
703    \value Rwanda
704    \value SaintBarthelemy
705    \value SaintHelena
706    \value SaintKittsAndNevis
707    \value SaintLucia
708    \value SaintMartin
709    \value SaintPierreAndMiquelon
710    \value SaintVincentAndTheGrenadines
711    \value Samoa
712    \value SanMarino
713    \value SaoTomeAndPrincipe
714    \value SaudiArabia
715    \value Senegal
716    \value Serbia
717    \value Seychelles
718    \value SierraLeone
719    \value Singapore
720    \value SintMaarten
721    \value Slovakia
722    \value Slovenia
723    \value SolomonIslands
724    \value Somalia
725    \value SouthAfrica
726    \value SouthGeorgiaAndTheSouthSandwichIslands
727    \value SouthKorea
728    \value SouthSudan
729    \value Spain
730    \value SriLanka
731    \value Sudan
732    \value Suriname
733    \value SvalbardAndJanMayenIslands
734    \value Swaziland
735    \value Sweden
736    \value Switzerland
737    \value Syria
738    \value SyrianArabRepublic Obsolete, please use Syria
739    \value Taiwan
740    \value Tajikistan
741    \value Tanzania
742    \value Thailand
743    \value Togo
744    \value TokelauCountry
745    \value Tokelau Obsolete, please use TokelauCountry
746    \value Tonga
747    \value TrinidadAndTobago
748    \value TristanDaCunha
749    \value Tunisia
750    \value Turkey
751    \value Turkmenistan
752    \value TurksAndCaicosIslands
753    \value TuvaluCountry
754    \value Tuvalu Obsolete, please use TuvaluCountry
755    \value Uganda
756    \value Ukraine
757    \value UnitedArabEmirates
758    \value UnitedKingdom
759    \value UnitedStates
760    \value UnitedStatesMinorOutlyingIslands
761    \value UnitedStatesVirginIslands
762    \value Uruguay
763    \value Uzbekistan
764    \value Vanuatu
765    \value VaticanCityState
766    \value Venezuela
767    \value Vietnam
768    \value WallisAndFutunaIslands
769    \value WesternSahara
770    \value World Since Qt 5.12
771    \value Yemen
772    \value Zambia
773    \value Zimbabwe
774
775    \omitvalue LastCountry
776
777    \sa country(), countryToString()
778*/
779
780/*!
781    \enum QLocale::Script
782
783    This enumerated type is used to specify a script.
784
785    \value AnyScript
786
787    \value AdlamScript Since Qt 5.7
788    \value AhomScript Since Qt 5.7
789    \value AnatolianHieroglyphsScript Since Qt 5.7
790    \value ArabicScript
791    \value ArmenianScript
792    \value AvestanScript Since Qt 5.1
793    \value BalineseScript Since Qt 5.1
794    \value BamumScript Since Qt 5.1
795    \value BassaVahScript Since Qt 5.5
796    \value BatakScript Since Qt 5.1
797    \value BengaliScript
798    \value BhaiksukiScript Since Qt 5.7
799    \value BopomofoScript Since Qt 5.1
800    \value BrahmiScript Since Qt 5.1
801    \value BrailleScript Since Qt 5.1
802    \value BugineseScript Since Qt 5.1
803    \value BuhidScript Since Qt 5.1
804    \value CanadianAboriginalScript Since Qt 5.1
805    \value CarianScript Since Qt 5.1
806    \value CaucasianAlbanianScript Since Qt 5.5
807    \value ChakmaScript Since Qt 5.1
808    \value ChamScript Since Qt 5.1
809    \value CherokeeScript
810    \value CopticScript Since Qt 5.1
811    \value CuneiformScript Since Qt 5.1
812    \value CypriotScript Since Qt 5.1
813    \value CyrillicScript
814    \value DeseretScript Since Qt 5.1
815    \value DevanagariScript
816    \value DuployanScript Since Qt 5.5
817    \value EgyptianHieroglyphsScript Since Qt 5.1
818    \value ElbasanScript Since Qt 5.5
819    \value EthiopicScript
820    \value FraserScript Since Qt 5.1
821    \value GeorgianScript
822    \value GlagoliticScript Since Qt 5.1
823    \value GothicScript Since Qt 5.1
824    \value GranthaScript Since Qt 5.5
825    \value GreekScript
826    \value GujaratiScript
827    \value GurmukhiScript
828    \value HangulScript Since Qt 5.1
829    \value HanScript Since Qt 5.1
830    \value HanunooScript Since Qt 5.1
831    \value HanWithBopomofoScript Since Qt 5.7
832    \value HatranScript Since Qt 5.7
833    \value HebrewScript
834    \value HiraganaScript Since Qt 5.1
835    \value ImperialAramaicScript Since Qt 5.1
836    \value InscriptionalPahlaviScript Since Qt 5.1
837    \value InscriptionalParthianScript Since Qt 5.1
838    \value JamoScript Since Qt 5.7
839    \value JapaneseScript
840    \value JavaneseScript Since Qt 5.1
841    \value KaithiScript Since Qt 5.1
842    \value KannadaScript
843    \value KatakanaScript Since Qt 5.1
844    \value KayahLiScript Since Qt 5.1
845    \value KharoshthiScript Since Qt 5.1
846    \value KhmerScript Since Qt 5.1
847    \value KhojkiScript Since Qt 5.5
848    \value KhudawadiScript Since Qt 5.5
849    \value KoreanScript
850    \value LannaScript Since Qt 5.1
851    \value LaoScript
852    \value LatinScript
853    \value LepchaScript Since Qt 5.1
854    \value LimbuScript Since Qt 5.1
855    \value LinearAScript Since Qt 5.5
856    \value LinearBScript Since Qt 5.1
857    \value LycianScript Since Qt 5.1
858    \value LydianScript Since Qt 5.1
859    \value MahajaniScript Since Qt 5.5
860    \value MalayalamScript
861    \value MandaeanScript Since Qt 5.1
862    \value ManichaeanScript Since Qt 5.5
863    \value MarchenScript Since Qt 5.7
864    \value MeiteiMayekScript Since Qt 5.1
865    \value MendeKikakuiScript Since Qt 5.5
866    \value MeroiticCursiveScript Since Qt 5.1
867    \value MeroiticScript Since Qt 5.1
868    \value ModiScript Since Qt 5.5
869    \value MongolianScript
870    \value MroScript Since Qt 5.5
871    \value MultaniScript Since Qt 5.7
872    \value MyanmarScript
873    \value NabataeanScript Since Qt 5.5
874    \value NewaScript Since Qt 5.7
875    \value NewTaiLueScript Since Qt 5.1
876    \value NkoScript Since Qt 5.1
877    \value OghamScript Since Qt 5.1
878    \value OlChikiScript Since Qt 5.1
879    \value OldHungarianScript Since Qt 5.7
880    \value OldItalicScript Since Qt 5.1
881    \value OldNorthArabianScript Since Qt 5.5
882    \value OldPermicScript Since Qt 5.5
883    \value OldPersianScript Since Qt 5.1
884    \value OldSouthArabianScript Since Qt 5.1
885    \value OriyaScript
886    \value OrkhonScript Since Qt 5.1
887    \value OsageScript Since Qt 5.7
888    \value OsmanyaScript Since Qt 5.1
889    \value PahawhHmongScript Since Qt 5.5
890    \value PalmyreneScript Since Qt 5.5
891    \value PauCinHauScript Since Qt 5.5
892    \value PhagsPaScript Since Qt 5.1
893    \value PhoenicianScript Since Qt 5.1
894    \value PollardPhoneticScript Since Qt 5.1
895    \value PsalterPahlaviScript Since Qt 5.5
896    \value RejangScript Since Qt 5.1
897    \value RunicScript Since Qt 5.1
898    \value SamaritanScript Since Qt 5.1
899    \value SaurashtraScript Since Qt 5.1
900    \value SharadaScript Since Qt 5.1
901    \value ShavianScript Since Qt 5.1
902    \value SiddhamScript Since Qt 5.5
903    \value SignWritingScript Since Qt 5.7
904    \value SimplifiedChineseScript same as SimplifiedHanScript
905    \value SimplifiedHanScript same as SimplifiedChineseScript
906    \value SinhalaScript
907    \value SoraSompengScript Since Qt 5.1
908    \value SundaneseScript Since Qt 5.1
909    \value SylotiNagriScript Since Qt 5.1
910    \value SyriacScript
911    \value TagalogScript Since Qt 5.1
912    \value TagbanwaScript Since Qt 5.1
913    \value TaiLeScript Since Qt 5.1
914    \value TaiVietScript Since Qt 5.1
915    \value TakriScript Since Qt 5.1
916    \value TamilScript
917    \value TangutScript Since Qt 5.7
918    \value TeluguScript
919    \value ThaanaScript
920    \value ThaiScript
921    \value TibetanScript
922    \value TifinaghScript
923    \value TirhutaScript Since Qt 5.5
924    \value TraditionalChineseScript same as TraditionalHanScript
925    \value TraditionalHanScript same as TraditionalChineseScript
926    \value UgariticScript Since Qt 5.1
927    \value VaiScript
928    \value VarangKshitiScript Since Qt 5.5
929    \value YiScript
930
931    \omitvalue LastScript
932
933    \sa script(), scriptToString(), languageToString()
934*/
935
936/*!
937    \enum QLocale::FormatType
938
939    This enum describes the different formats that can be used when
940    converting QDate, QTime, and QDateTime objects, as well
941    as months and days, to strings specific to the locale.
942
943    \value LongFormat Longer format.
944
945    \value ShortFormat Shorter format.
946
947    \value NarrowFormat A special version for use when space is very limited.
948
949    \note \c NarrowFormat might contain the same text for
950    different months and days. It can even be an empty string if the
951    locale doesn't support narrow names, so you should avoid using it
952    for date formatting. Also, for the system locale this format is
953    the same as \c ShortFormat.
954
955    \sa dateFormat(), timeFormat(), dateTimeFormat()
956    \sa monthName(), standaloneMonthName(), dayName(), standaloneDayName()
957    \sa toDate(), toTime(), toDateTime()
958*/
959
960/*!
961    \enum QLocale::NumberOption
962
963    This enum defines a set of options for number-to-string and string-to-number
964    conversions. They can be retrieved with numberOptions() and set with
965    setNumberOptions().
966
967    \value DefaultNumberOptions This option represents the default behavior, with
968            group separators, with one leading zero in single digit exponents, and
969            without trailing zeroes after the decimal dot.
970    \value OmitGroupSeparator If this option is set, the number-to-string functions
971            will not insert group separators in their return values. The default
972            is to insert group separators.
973    \value RejectGroupSeparator If this option is set, the string-to-number functions
974            will fail if they encounter group separators in their input. The default
975            is to accept numbers containing correctly placed group separators.
976    \value OmitLeadingZeroInExponent If this option is set, the number-to-string
977            functions will not pad exponents with zeroes when printing floating point
978            numbers in scientific notation. The default is to add one leading zero to
979            single digit exponents.
980    \value RejectLeadingZeroInExponent If this option is set, the string-to-number
981            functions will fail if they encounter an exponent padded with zeroes when
982            parsing a floating point number in scientific notation. The default is to
983            accept such padding.
984    \value IncludeTrailingZeroesAfterDot If this option is set, the number-to-string
985            functions will pad numbers with zeroes to the requested precision in "g"
986            or "most concise" mode, even if the number of significant digits is lower
987            than the requested precision. The default is to omit trailing zeroes.
988    \value RejectTrailingZeroesAfterDot If this option is set, the string-to-number
989            functions will fail if they encounter trailing zeroes after the decimal
990            dot when parsing a number in scientific or decimal representation. The
991            default is to accept trailing zeroes.
992
993    \sa setNumberOptions(), numberOptions()
994*/
995
996/*!
997    \enum QLocale::FloatingPointPrecisionOption
998
999    This enum defines constants that can be given as precision to QString::number(),
1000    QByteArray::number(), and QLocale::toString() when converting floats or doubles,
1001    in order to express a variable number of digits as precision.
1002
1003    \value FloatingPointShortest The conversion algorithm will try to find the
1004            shortest accurate representation for the given number. "Accurate" means
1005            that you get the exact same number back from an inverse conversion on
1006            the generated string representation.
1007
1008    \sa toString(), QString, QByteArray
1009
1010    \since 5.7
1011*/
1012
1013/*!
1014    \enum QLocale::MeasurementSystem
1015
1016    This enum defines which units are used for measurement.
1017
1018    \value MetricSystem This value indicates metric units, such as meters,
1019            centimeters and millimeters.
1020    \value ImperialUSSystem This value indicates imperial units, such as inches and
1021            miles as they are used in the United States.
1022    \value ImperialUKSystem This value indicates imperial units, such as inches and
1023            miles as they are used in the United Kingdom.
1024    \value ImperialSystem Provided for compatibility. Same as ImperialUSSystem
1025
1026    \since 4.4
1027*/
1028
1029
1030/*!
1031    \fn bool QLocale::operator==(const QLocale &other) const
1032
1033    Returns \c true if the QLocale object is the same as the \a other
1034    locale specified; otherwise returns \c false.
1035*/
1036
1037/*!
1038    \fn bool QLocale::operator!=(const QLocale &other) const
1039
1040    Returns \c true if the QLocale object is not the same as the \a other
1041    locale specified; otherwise returns \c false.
1042*/
1043
1044/*!
1045    \enum QLocale::QuotationStyle
1046
1047    This enum defines a set of possible styles for locale specific quotation.
1048
1049    \value StandardQuotation If this option is set, the standard quotation marks
1050            will be used to quote strings.
1051    \value AlternateQuotation If this option is set, the alternate quotation marks
1052            will be used to quote strings.
1053
1054    \since 4.8
1055
1056    \sa quoteString()
1057*/
1058
1059/*!
1060    \internal
1061    \class QSystemLocale
1062    \inmodule QtCore
1063    \brief The QSystemLocale class can be used to finetune the system locale
1064    of the user.
1065    \since 4.2
1066
1067    \ingroup i18n
1068
1069    \warning This class is only useful in very rare cases. Usually QLocale offers
1070    all the functionality required for application development.
1071
1072    QSystemLocale allows to override the values provided by the system
1073    locale (QLocale::system()).
1074
1075    \sa QLocale
1076*/
1077
1078/*!
1079  \enum QSystemLocale::QueryType
1080
1081  Specifies the type of information queried by query(). For each value
1082  the type of information to return from the query() method is listed.
1083
1084  \value LanguageId a uint specifying the language.
1085  \value ScriptId a uint specifying the script.
1086  \value CountryId a uint specifying the country.
1087  \value DecimalPoint a QString specifying the decimal point.
1088  \value GroupSeparator a QString specifying the group separator.
1089  \value ZeroDigit a QString specifying the zero digit.
1090  \value NegativeSign a QString specifying the minus sign.
1091  \value PositiveSign a QString specifying the plus sign.
1092  \value DateFormatLong a QString specifying the long date format
1093  \value DateFormatShort a QString specifying the short date format
1094  \value TimeFormatLong a QString specifying the long time format
1095  \value TimeFormatShort a QString specifying the short time format
1096  \value DayNameLong a QString specifying the name of a weekday. the in variant contains an integer between 1 and 7 (Monday - Sunday)
1097  \value DayNameShort a QString specifying the short name of a weekday. the in variant contains an integer between 1 and 7 (Monday - Sunday)
1098  \value MonthNameLong a QString specifying the name of a month. the in variant contains an integer between 1 and 12
1099  \value MonthNameShort a QString specifying the short name of a month. the in variant contains an integer between 1 and 12
1100  \value DateToStringLong converts the QDate stored in the in variant to a QString using the long date format
1101  \value DateToStringShort converts the QDate stored in the in variant to a QString using the short date format
1102  \value TimeToStringLong converts the QTime stored in the in variant to a QString using the long time format
1103  \value TimeToStringShort converts the QTime stored in the in variant to a QString using the short time format
1104  \value DateTimeFormatLong a QString specifying the long date time format
1105  \value DateTimeFormatShort a QString specifying the short date time format
1106  \value DateTimeToStringLong converts the QDateTime in the in variant to a QString using the long datetime format
1107  \value DateTimeToStringShort converts the QDateTime in the in variant to a QString using the short datetime format
1108  \value MeasurementSystem a QLocale::MeasurementSystem enum specifying the measurement system
1109  \value AMText a string that represents the system AM designator associated with a 12-hour clock.
1110  \value PMText a string that represents the system PM designator associated with a 12-hour clock.
1111  \value FirstDayOfWeek a Qt::DayOfWeek enum specifiying the first day of the week
1112  \value CurrencySymbol a string that represents a currency in a format QLocale::CurrencyFormat.
1113  \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.
1114  \value UILanguages a list of strings representing locale names that could be used for UI translation.
1115  \value StringToStandardQuotation a QString containing a quoted version of the string ref stored in the in variant using standard quotes.
1116  \value StringToAlternateQuotation a QString containing a quoted version of the string ref stored in the in variant using alternate quotes.
1117  \value Weekdays a QList<Qt::DayOfWeek> specifying the regular weekdays
1118  \value LocaleChanged this type is queried whenever the system locale is changed.
1119  \value ListToSeparatedString a string that represents a join of a given QStringList with a locale-defined separator.
1120  \value NativeLanguageName a string that represents the name of the native language.
1121  \value NativeCountryName a string that represents the name of the native country.
1122
1123  \sa FormatType
1124*/
1125
1126/*!
1127    \fn QLocale QSystemLocale::fallbackUiLocale() const
1128
1129    \since 4.6
1130    Returns the fallback locale obtained from the system.
1131*/
1132
1133/*!
1134    \fn QVariant QSystemLocale::query(QueryType type, QVariant in = QVariant()) const
1135
1136    Generic query method for locale data. Provides indirection.
1137    Denotes the \a type of the query
1138    with \a in as input data depending on the query.
1139
1140    \sa QSystemLocale::QueryType
1141*/
1142
1143/*!
1144    \class QSystemLocale::CurrencyToStringArgument
1145    \inmodule QtCore
1146
1147    A helper class that provides arguments for the QSystemLocale::query()
1148    function with query type QSystemLocale::CurrencyToString.
1149
1150    \sa QSystemLocale::QueryType
1151    \since 4.8
1152*/
1153
1154/*!
1155    \fn QSystemLocale::CurrencyToStringArgument::CurrencyToStringArgument()
1156    \internal
1157*/
1158/*!
1159    \variable QSystemLocale::CurrencyToStringArgument::value
1160
1161    An input value that should be converted to its string representation.
1162    Contains one of QVariant::LongLong, QVariant::ULongLong or QVariant::Double
1163    types.
1164*/
1165/*!
1166    \variable QSystemLocale::CurrencyToStringArgument::symbol
1167
1168    An optional argument containing a currency symbol to be used in the
1169    currency string.
1170*/
1171
1172/*!
1173\fn QString QLocale::toString(long i) const
1174
1175\overload
1176
1177\sa toLong()
1178*/
1179
1180/*!
1181\fn QString QLocale::toString(ulong i) const
1182
1183\overload
1184
1185\sa toULong()
1186*/
1187
1188/*!
1189\fn QString QLocale::toString(ushort i) const
1190
1191\overload
1192
1193\sa toUShort()
1194*/
1195
1196
1197/*!
1198\fn QString QLocale::toString(short i) const
1199
1200\overload
1201
1202\sa toShort()
1203*/
1204
1205/*!
1206\fn QString QLocale::toString(int i) const
1207
1208\overload
1209
1210\sa toInt()
1211*/
1212
1213/*!
1214\fn QString QLocale::toString(uint i) const
1215
1216\overload
1217
1218\sa toUInt()
1219*/
1220
1221/*
1222\fn QString QLocale::toString(long i) const
1223
1224\overload
1225
1226\sa  toLong()
1227*/
1228
1229/*
1230\fn QString QLocale::toString(ulong i) const
1231
1232\overload
1233
1234\sa toULong()
1235*/
1236
1237/*!
1238\fn QString QLocale::toString(float i, char f = 'g', int prec = 6) const
1239
1240\overload
1241
1242\a f and \a prec have the same meaning as in QString::number(double, char, int).
1243
1244\sa toDouble()
1245*/
1246
1247/*!
1248    \fn QString QLocale::toCurrencyString(short value, const QString &symbol) const
1249    \since 4.8
1250    \overload
1251*/
1252
1253/*!
1254    \fn QString QLocale::toCurrencyString(ushort value, const QString &symbol) const
1255    \since 4.8
1256    \overload
1257*/
1258
1259/*!
1260    \fn QString QLocale::toCurrencyString(int value, const QString &symbol) const
1261    \since 4.8
1262    \overload
1263*/
1264
1265/*!
1266    \fn QString QLocale::toCurrencyString(uint value, const QString &symbol) const
1267    \since 4.8
1268    \overload
1269*/
1270/*!
1271    \fn QString QLocale::toCurrencyString(float value, const QString &symbol) const
1272    \since 4.8
1273    \overload
1274*/
1275