QLocale(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

✨ NAME ✨

QLocale — the lil icon that converts between numbers and their string representations in various languages 🌍💬

That's the whole job bestie. Numbers in, cute localized strings out (and back again). No cap.

🦋 SYNOPSIS 🦋

okay so before we get into it, one big heads-up: almost all the functions in this class are reentrant when Qt is built with thread support. The exception is setDefault(). So if you're threading, that one function is the odd one out — it's giving main-character-only, single-file energy 💅

#include <qlocale.h>

👑 Public Members 👑

🌈 The `Language` enum (140 of them, we are FED)

fr fr it's the whole world in here:

enum Language {
    C = 1, Abkhazian = 2, Afan = 3, Afar = 4, Afrikaans = 5,
    Albanian = 6, Amharic = 7, Arabic = 8, Armenian = 9, Assamese = 10,
    Aymara = 11, Azerbaijani = 12, Bashkir = 13, Basque = 14, Bengali = 15,
    Bhutani = 16, Bihari = 17, Bislama = 18, Breton = 19, Bulgarian = 20,
    Burmese = 21, Byelorussian = 22, Cambodian = 23, Catalan = 24, Chinese = 25,
    Corsican = 26, Croatian = 27, Czech = 28, Danish = 29, Dutch = 30,
    English = 31, Esperanto = 32, Estonian = 33, Faroese = 34, FijiLanguage = 35,
    Finnish = 36, French = 37, Frisian = 38, Gaelic = 39, Galician = 40,
    Georgian = 41, German = 42, Greek = 43, Greenlandic = 44, Guarani = 45,
    Gujarati = 46, Hausa = 47, Hebrew = 48, Hindi = 49, Hungarian = 50,
    Icelandic = 51, Indonesian = 52, Interlingua = 53, Interlingue = 54, Inuktitut = 55,
    Inupiak = 56, Irish = 57, Italian = 58, Japanese = 59, Javanese = 60,
    Kannada = 61, Kashmiri = 62, Kazakh = 63, Kinyarwanda = 64, Kirghiz = 65,
    Korean = 66, Kurdish = 67, Kurundi = 68, Laothian = 69, Latin = 70,
    Latvian = 71, Lingala = 72, Lithuanian = 73, Macedonian = 74, Malagasy = 75,
    Malay = 76, Malayalam = 77, Maltese = 78, Maori = 79, Marathi = 80,
    Moldavian = 81, Mongolian = 82, NauruLanguage = 83, Nepali = 84, Norwegian = 85,
    Occitan = 86, Oriya = 87, Pashto = 88, Persian = 89, Polish = 90,
    Portuguese = 91, Punjabi = 92, Quechua = 93, RhaetoRomance = 94, Romanian = 95,
    Russian = 96, Samoan = 97, Sangho = 98, Sanskrit = 99, Serbian = 100,
    SerboCroatian = 101, Sesotho = 102, Setswana = 103, Shona = 104, Sindhi = 105,
    Singhalese = 106, Siswati = 107, Slovak = 108, Slovenian = 109, Somali = 110,
    Spanish = 111, Sundanese = 112, Swahili = 113, Swedish = 114, Tagalog = 115,
    Tajik = 116, Tamil = 117, Tatar = 118, Telugu = 119, Thai = 120,
    Tibetan = 121, Tigrinya = 122, TongaLanguage = 123, Tsonga = 124, Turkish = 125,
    Turkmen = 126, Twi = 127, Uigur = 128, Ukrainian = 129, Urdu = 130,
    Uzbek = 131, Vietnamese = 132, Volapuk = 133, Welsh = 134, Wolof = 135,
    Xhosa = 136, Yiddish = 137, Yoruba = 138, Zhuang = 139, Zulu = 140,
    LastLanguage = Zulu
};

Note bestie: LastLanguage is literally just an alias for Zulu, and C starts at 1 — that's it, that's the whole tea ☕

🗺️ The `Country` enum (241 entries, we are so back)

enum Country {
    AnyCountry = 0, Afghanistan = 1, Albania = 2, Algeria = 3, AmericanSamoa = 4,
    Andorra = 5, Angola = 6, Anguilla = 7, Antarctica = 8, AntiguaAndBarbuda = 9,
    Argentina = 10, Armenia = 11, Aruba = 12, Australia = 13, Austria = 14,
    Azerbaijan = 15, Bahamas = 16, Bahrain = 17, Bangladesh = 18, Barbados = 19,
    Belarus = 20, Belgium = 21, Belize = 22, Benin = 23, Bermuda = 24,
    Bhutan = 25, Bolivia = 26, BosniaAndHerzegowina = 27, Botswana = 28, BouvetIsland = 29,
    Brazil = 30, BritishIndianOceanTerritory = 31, BruneiDarussalam = 32, Bulgaria = 33, BurkinaFaso = 34,
    Burundi = 35, Cambodia = 36, Cameroon = 37, Canada = 38, CapeVerde = 39,
    CaymanIslands = 40, CentralAfricanRepublic = 41, Chad = 42, Chile = 43, China = 44,
    ChristmasIsland = 45, CocosIslands = 46, Colombia = 47, Comoros = 48, DemocraticRepublicOfCongo = 49,
    PeoplesRepublicOfCongo = 50, CookIslands = 51, CostaRica = 52, IvoryCoast = 53, Croatia = 54,
    Cuba = 55, Cyprus = 56, CzechRepublic = 57, Denmark = 58, Djibouti = 59,
    Dominica = 60, DominicanRepublic = 61, EastTimor = 62, Ecuador = 63, Egypt = 64,
    ElSalvador = 65, EquatorialGuinea = 66, Eritrea = 67, Estonia = 68, Ethiopia = 69,
    FalklandIslands = 70, FaroeIslands = 71, FijiCountry = 72, Finland = 73, France = 74,
    MetropolitanFrance = 75, FrenchGuiana = 76, FrenchPolynesia = 77, FrenchSouthernTerritories = 78, Gabon = 79,
    Gambia = 80, Georgia = 81, Germany = 82, Ghana = 83, Gibraltar = 84,
    Greece = 85, Greenland = 86, Grenada = 87, Guadeloupe = 88, Guam = 89,
    Guatemala = 90, Guinea = 91, GuineaBissau = 92, Guyana = 93, Haiti = 94,
    HeardAndMcDonaldIslands = 95, Honduras = 96, HongKong = 97, Hungary = 98, Iceland = 99,
    India = 100, Indonesia = 101, Iran = 102, Iraq = 103, Ireland = 104,
    Israel = 105, Italy = 106, Jamaica = 107, Japan = 108, Jordan = 109,
    Kazakhstan = 110, Kenya = 111, Kiribati = 112, DemocraticRepublicOfKorea = 113, RepublicOfKorea = 114,
    Kuwait = 115, Kyrgyzstan = 116, Lao = 117, Latvia = 118, Lebanon = 119,
    Lesotho = 120, Liberia = 121, LibyanArabJamahiriya = 122, Liechtenstein = 123, Lithuania = 124,
    Luxembourg = 125, Macau = 126, Macedonia = 127, Madagascar = 128, Malawi = 129,
    Malaysia = 130, Maldives = 131, Mali = 132, Malta = 133, MarshallIslands = 134,
    Martinique = 135, Mauritania = 136, Mauritius = 137, Mayotte = 138, Mexico = 139,
    Micronesia = 140, Moldova = 141, Monaco = 142, Mongolia = 143, Montserrat = 144,
    Morocco = 145, Mozambique = 146, Myanmar = 147, Namibia = 148, NauruCountry = 149,
    Nepal = 150, Netherlands = 151, NetherlandsAntilles = 152, NewCaledonia = 153, NewZealand = 154,
    Nicaragua = 155, Niger = 156, Nigeria = 157, Niue = 158, NorfolkIsland = 159,
    NorthernMarianaIslands = 160, Norway = 161, Oman = 162, Pakistan = 163, Palau = 164,
    PalestinianTerritory = 165, Panama = 166, PapuaNewGuinea = 167, Paraguay = 168, Peru = 169,
    Philippines = 170, Pitcairn = 171, Poland = 172, Portugal = 173, PuertoRico = 174,
    Qatar = 175, Reunion = 176, Romania = 177, RussianFederation = 178, Rwanda = 179,
    SaintKittsAndNevis = 180, StLucia = 181, StVincentAndTheGrenadines = 182, Samoa = 183, SanMarino = 184,
    SaoTomeAndPrincipe = 185, SaudiArabia = 186, Senegal = 187, Seychelles = 188, SierraLeone = 189,
    Singapore = 190, Slovakia = 191, Slovenia = 192, SolomonIslands = 193, Somalia = 194,
    SouthAfrica = 195, SouthGeorgiaAndTheSouthSandwichIslands = 196, Spain = 197, SriLanka = 198, StHelena = 199,
    StPierreAndMiquelon = 200, Sudan = 201, Suriname = 202, SvalbardAndJanMayenIslands = 203, Swaziland = 204,
    Sweden = 205, Switzerland = 206, SyrianArabRepublic = 207, Taiwan = 208, Tajikistan = 209,
    Tanzania = 210, Thailand = 211, Togo = 212, Tokelau = 213, TongaCountry = 214,
    TrinidadAndTobago = 215, Tunisia = 216, Turkey = 217, Turkmenistan = 218, TurksAndCaicosIslands = 219,
    Tuvalu = 220, Uganda = 221, Ukraine = 222, UnitedArabEmirates = 223, UnitedKingdom = 224,
    UnitedStates = 225, UnitedStatesMinorOutlyingIslands = 226, Uruguay = 227, Uzbekistan = 228, Vanuatu = 229,
    VaticanCityState = 230, Venezuela = 231, VietNam = 232, BritishVirginIslands = 233, USVirginIslands = 234,
    WallisAndFutunaIslands = 235, WesternSahara = 236, Yemen = 237, Yugoslavia = 238, Zambia = 239,
    Zimbabwe = 240, LastCountry = Zimbabwe
};

And again: LastCountry is just Zimbabwe. Also AnyCountry = 0 is your "idk bestie, anywhere" option 🫶

🎀 Constructors + assignment (the "make me a QLocale" squad)

QLocale () — default-constructed. A blank slate, a fresh face, a new era 💖
QLocale ( const QString & name ) — build one from a QString name 🏷️
QLocale ( Language language, Country country = AnyCountry ) — give it a Language and optionally a Country; the country defaults to AnyCountry ✨
QLocale ( const QLocale & other ) — copy constructor, twin energy 👯
QLocale & operator= ( const QLocale & other ) — assignment operator, for when you need to swap the whole vibe 🔁

🔍 The getters (tell me who you are)

Language language () const — hands you back the Language
Country country () const — hands you back the Country
QString name () const — hands you back the name as a QString

🧮 The `to*` family — string goes IN, number comes OUT

Every single one of these takes a const QString & s and a bool * ok = 0, and yes, the ok pointer defaults to 0 on all of them, no cap:

short toShort ( const QString & s, bool * ok = 0 ) const
ushort toUShort ( const QString & s, bool * ok = 0 ) const
int toInt ( const QString & s, bool * ok = 0 ) const
uint toUInt ( const QString & s, bool * ok = 0 ) const
Q_LONG toLong ( const QString & s, bool * ok = 0 ) const
Q_ULONG toULong ( const QString & s, bool * ok = 0 ) const
Q_LLONG toLongLong ( const QString & s, bool * ok = 0 ) const
Q_ULLONG toULongLong ( const QString & s, bool * ok = 0 ) const
float toFloat ( const QString & s, bool * ok = 0 ) const
double toDouble ( const QString & s, bool * ok = 0 ) const

One per numeric type bestie. They said "cover every integer width" and they MEANT it 💅

✨ The `toString` family — number goes IN, cute string comes OUT

The integer overloads, one for every integer type:

QString toString ( short i ) const
QString toString ( ushort i ) const
QString toString ( int i ) const
QString toString ( uint i ) const
QString toString ( Q_LONG i ) const
QString toString ( Q_ULONG i ) const
QString toString ( Q_LLONG i ) const
QString toString ( Q_ULLONG i ) const

And the floating-point ones, which get extra seasoning — a format char f and a precision prec:

QString toString ( float i, char f = 'g', int prec = 6 ) const
QString toString ( double i, char f = 'g', int prec = 6 ) const

Note the defaults on those two: f defaults to 'g' and prec defaults to 6. Those are the exact defaults, don't let anyone tell you otherwise 🔥

🌟 Static Public Members 🌟

QString languageToString ( Language language ) — static, takes a Language, gives you a QString 🌸
QString countryToString ( Country country ) — static, takes a Country, gives you a QString 🌍
void setDefault ( const QLocale & locale ) — static, sets the default locale. ⚠️ And remember from the top: this is the ONE function in this whole class that is not reentrant when Qt is built with thread support. Everyone else is chill, she is not 🙈
QLocale c () — static, returns a QLocale 💜
QLocale system () — static, returns a QLocale 🖥️

okay that's the whole map of the class bestie, we got the languages, we got the countries, we got the conversions 🦋

to be continued… there's more of this page coming, so hold that thought 💖✨

💖 DESCRIPTION 💖

Okay bestie, gather round, because QLocale is literally the moment. It's the class that converts between numbers and their string representations in various languages — like, all of them. It is giving polyglot main character energy and we are obsessed. 🌍✨

You birth a QLocale with a country/language pair in its constructor, and then it hands you number-to-string and string-to-number conversion functions that are basically the same vibe as the ones hanging out in QString.

QLocale egyptian(QLocale::Arabic, QLocale::Egypt);
QString s1 = egyptian.toString(1.571429E+07, 'e');
QString s2 = egyptian.toString(10);
double d = egyptian.toDouble(s1);
int s2 = egyptian.toInt(s2);

QLocale also understands the concept of a default locale, which gets figured out from the system's locale settings at application startup. You can swap it out whenever by calling the static member setDefault(). And the default locale has these effects, no cap:

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

QLocale::setDefault(QLocale(QLocale::Hebrew, QLocale::Israel));
QLocale hebrew; // Constructs a default QLocale
QString s1 = hebrew.toString(15714.3, 'e');
bool ok;
double d;
QLocale::setDefault(QLocale::C);
d = QString( "1234,56" ).toDouble(&ok); // ok == false
d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
QLocale::setDefault(QLocale::German);
d = QString( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString( "%1 %L2 %L3" )
        .arg( 12345 )
        .arg( 12345 )
        .arg( 12345, 0, 16 );
// str == "12345 12,345 3039"

So when you specify a language/country pair in the constructor, one of three things can happen:

If the language/country pair is found in the database, it is used. Slay, straightforward.
If the language is found but the country is not, or if the country is AnyCountry, then the language is used with the most appropriate available country (for example, Germany for German). Close enough, bestie. 💅
If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()). Rip, but okay.

Fun fact: the "C" locale is identical to English/UnitedStates. Iconic crossover.

Wanna know which language and country values actually got used? Call language() and country(). Done. ✅

There's also an alternative way to construct a QLocale object: just hand it the locale name.

QLocale korean("ko");
QLocale swiss("de_CH");

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

And heads up: all the methods in QLocale, with the exception of setDefault(), are reentrant. 🧚

See also QString::toDouble(), QString::arg(), and Text Related Classes.

Now for the legal girlies — the double-to-string and string-to-double conversion functions are covered by the following licenses:

Permission to use, copy, modify, and distribute this software for any purpose without fee is hereby granted, provided that this entire notice is included in all copies of any software which is or includes a copy or modification of this software and in all copies of the supporting documentation for such software.

THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR AT&T MAKES ANY REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.

This product includes software developed by the University of California, Berkeley and its contributors.

📚 Member Type Documentation 📚

🌈 QLocale::Country 🌈

This enumerated type is used to specify a country. Here's the whole roster, bestie — every single one, and yes we're listing them all because we don't skip. 💀

QLocale::AnyCountry
QLocale::Afghanistan
QLocale::Albania
QLocale::Algeria
QLocale::AmericanSamoa
QLocale::Andorra
QLocale::Angola
QLocale::Anguilla
QLocale::Antarctica
QLocale::AntiguaAndBarbuda
QLocale::Argentina
QLocale::Armenia
QLocale::Aruba
QLocale::Australia
QLocale::Austria
QLocale::Azerbaijan
QLocale::Bahamas
QLocale::Bahrain
QLocale::Bangladesh
QLocale::Barbados
QLocale::Belarus
QLocale::Belgium
QLocale::Belize
QLocale::Benin
QLocale::Bermuda
QLocale::Bhutan
QLocale::Bolivia
QLocale::BosniaAndHerzegowina
QLocale::Botswana
QLocale::BouvetIsland
QLocale::Brazil
QLocale::BritishIndianOceanTerritory
QLocale::BruneiDarussalam
QLocale::Bulgaria
QLocale::BurkinaFaso
QLocale::Burundi
QLocale::Cambodia
QLocale::Cameroon
QLocale::Canada
QLocale::CapeVerde
QLocale::CaymanIslands
QLocale::CentralAfricanRepublic
QLocale::Chad
QLocale::Chile
QLocale::China
QLocale::ChristmasIsland
QLocale::CocosIslands
QLocale::Colombia
QLocale::Comoros
QLocale::DemocraticRepublicOfCongo
QLocale::PeoplesRepublicOfCongo
QLocale::CookIslands
QLocale::CostaRica
QLocale::IvoryCoast
QLocale::Croatia
QLocale::Cuba
QLocale::Cyprus
QLocale::CzechRepublic
QLocale::Denmark
QLocale::Djibouti
QLocale::Dominica
QLocale::DominicanRepublic
QLocale::EastTimor
QLocale::Ecuador
QLocale::Egypt
QLocale::ElSalvador
QLocale::EquatorialGuinea
QLocale::Eritrea
QLocale::Estonia
QLocale::Ethiopia
QLocale::FalklandIslands
QLocale::FaroeIslands
QLocale::FijiCountry
QLocale::Finland
QLocale::France
QLocale::MetropolitanFrance
QLocale::FrenchGuiana
QLocale::FrenchPolynesia
QLocale::FrenchSouthernTerritories
QLocale::Gabon
QLocale::Gambia
QLocale::Georgia
QLocale::Germany
QLocale::Ghana
QLocale::Gibraltar
QLocale::Greece
QLocale::Greenland
QLocale::Grenada
QLocale::Guadeloupe
QLocale::Guam
QLocale::Guatemala
QLocale::Guinea
QLocale::GuineaBissau
QLocale::Guyana
QLocale::Haiti
QLocale::HeardAndMcDonaldIslands
QLocale::Honduras
QLocale::HongKong
QLocale::Hungary
QLocale::Iceland
QLocale::India
QLocale::Indonesia
QLocale::Iran
QLocale::Iraq
QLocale::Ireland
QLocale::Israel
QLocale::Italy
QLocale::Jamaica
QLocale::Japan
QLocale::Jordan
QLocale::Kazakhstan
QLocale::Kenya
QLocale::Kiribati
QLocale::DemocraticRepublicOfKorea
QLocale::RepublicOfKorea
QLocale::Kuwait
QLocale::Kyrgyzstan
QLocale::Lao
QLocale::Latvia
QLocale::Lebanon
QLocale::Lesotho
QLocale::Liberia
QLocale::LibyanArabJamahiriya
QLocale::Liechtenstein
QLocale::Lithuania
QLocale::Luxembourg
QLocale::Macau
QLocale::Macedonia
QLocale::Madagascar
QLocale::Malawi
QLocale::Malaysia
QLocale::Maldives
QLocale::Mali
QLocale::Malta
QLocale::MarshallIslands
QLocale::Martinique
QLocale::Mauritania
QLocale::Mauritius
QLocale::Mayotte
QLocale::Mexico
QLocale::Micronesia
QLocale::Moldova
QLocale::Monaco
QLocale::Mongolia
QLocale::Montserrat
QLocale::Morocco
QLocale::Mozambique
QLocale::Myanmar
QLocale::Namibia
QLocale::NauruCountry
QLocale::Nepal
QLocale::Netherlands
QLocale::NetherlandsAntilles
QLocale::NewCaledonia
QLocale::NewZealand
QLocale::Nicaragua
QLocale::Niger
QLocale::Nigeria
QLocale::Niue
QLocale::NorfolkIsland
QLocale::NorthernMarianaIslands
QLocale::Norway
QLocale::Oman
QLocale::Pakistan
QLocale::Palau
QLocale::PalestinianTerritory
QLocale::Panama
QLocale::PapuaNewGuinea
QLocale::Paraguay
QLocale::Peru
QLocale::Philippines
QLocale::Pitcairn
QLocale::Poland
QLocale::Portugal
QLocale::PuertoRico
QLocale::Qatar
QLocale::Reunion
QLocale::Romania
QLocale::RussianFederation
QLocale::Rwanda
QLocale::SaintKittsAndNevis
QLocale::StLucia
QLocale::StVincentAndTheGrenadines
QLocale::Samoa
QLocale::SanMarino
QLocale::SaoTomeAndPrincipe
QLocale::SaudiArabia
QLocale::Senegal
QLocale::Seychelles
QLocale::SierraLeone
QLocale::Singapore
QLocale::Slovakia
QLocale::Slovenia
QLocale::SolomonIslands
QLocale::Somalia
QLocale::SouthAfrica
QLocale::SouthGeorgiaAndTheSouthSandwichIslands
QLocale::Spain
QLocale::SriLanka
QLocale::StHelena
QLocale::StPierreAndMiquelon
QLocale::Sudan
QLocale::Suriname
QLocale::SvalbardAndJanMayenIslands
QLocale::Swaziland
QLocale::Sweden
QLocale::Switzerland
QLocale::SyrianArabRepublic
QLocale::Taiwan
QLocale::Tajikistan
QLocale::Tanzania
QLocale::Thailand
QLocale::Togo
QLocale::Tokelau
QLocale::TongaCountry
QLocale::TrinidadAndTobago
QLocale::Tunisia
QLocale::Turkey
QLocale::Turkmenistan
QLocale::TurksAndCaicosIslands
QLocale::Tuvalu
QLocale::Uganda
QLocale::Ukraine
QLocale::UnitedArabEmirates
QLocale::UnitedKingdom
QLocale::UnitedStates
QLocale::UnitedStatesMinorOutlyingIslands
QLocale::Uruguay
QLocale::Uzbekistan
QLocale::Vanuatu
QLocale::VaticanCityState
QLocale::Venezuela
QLocale::VietNam
QLocale::BritishVirginIslands
QLocale::USVirginIslands
QLocale::WallisAndFutunaIslands
QLocale::WesternSahara
QLocale::Yemen
QLocale::Yugoslavia
QLocale::Zambia
QLocale::Zimbabwe

And that's literally the entire country roster, bestie. Every single one accounted for, no skips, no shortcuts. 🎀

🌍 QLocale::Language 🌍

okay bestie, this enumerated type is literally just here to specify a language 💖 that's it, that's the whole job.

QLocale::C — identical to English/UnitedStates 👑

and now the full roster, no skipping, we list every single one because we're thorough like that:

QLocale::Abkhazian
QLocale::Afan
QLocale::Afar
QLocale::Afrikaans
QLocale::Albanian
QLocale::Amharic
QLocale::Arabic
QLocale::Armenian
QLocale::Assamese
QLocale::Aymara
QLocale::Azerbaijani
QLocale::Bashkir
QLocale::Basque
QLocale::Bengali
QLocale::Bhutani
QLocale::Bihari
QLocale::Bislama
QLocale::Breton
QLocale::Bulgarian
QLocale::Burmese
QLocale::Byelorussian
QLocale::Cambodian
QLocale::Catalan
QLocale::Chinese
QLocale::Corsican
QLocale::Croatian
QLocale::Czech
QLocale::Danish
QLocale::Dutch
QLocale::English
QLocale::Esperanto
QLocale::Estonian
QLocale::Faroese
QLocale::FijiLanguage
QLocale::Finnish
QLocale::French
QLocale::Frisian
QLocale::Gaelic
QLocale::Galician
QLocale::Georgian
QLocale::German
QLocale::Greek
QLocale::Greenlandic
QLocale::Guarani
QLocale::Gujarati
QLocale::Hausa
QLocale::Hebrew
QLocale::Hindi
QLocale::Hungarian
QLocale::Icelandic
QLocale::Indonesian
QLocale::Interlingua
QLocale::Interlingue
QLocale::Inuktitut
QLocale::Inupiak
QLocale::Irish
QLocale::Italian
QLocale::Japanese
QLocale::Javanese
QLocale::Kannada
QLocale::Kashmiri
QLocale::Kazakh
QLocale::Kinyarwanda
QLocale::Kirghiz
QLocale::Korean
QLocale::Kurdish
QLocale::Kurundi
QLocale::Laothian
QLocale::Latin
QLocale::Latvian
QLocale::Lingala
QLocale::Lithuanian
QLocale::Macedonian
QLocale::Malagasy
QLocale::Malay
QLocale::Malayalam
QLocale::Maltese
QLocale::Maori
QLocale::Marathi
QLocale::Moldavian
QLocale::Mongolian
QLocale::NauruLanguage
QLocale::Nepali
QLocale::Norwegian
QLocale::Occitan
QLocale::Oriya
QLocale::Pashto
QLocale::Persian
QLocale::Polish
QLocale::Portuguese
QLocale::Punjabi
QLocale::Quechua
QLocale::RhaetoRomance
QLocale::Romanian
QLocale::Russian
QLocale::Samoan
QLocale::Sangho
QLocale::Sanskrit
QLocale::Serbian
QLocale::SerboCroatian
QLocale::Sesotho
QLocale::Setswana
QLocale::Shona
QLocale::Sindhi
QLocale::Singhalese
QLocale::Siswati
QLocale::Slovak
QLocale::Slovenian
QLocale::Somali
QLocale::Spanish
QLocale::Sundanese
QLocale::Swahili
QLocale::Swedish
QLocale::Tagalog
QLocale::Tajik
QLocale::Tamil
QLocale::Tatar
QLocale::Telugu
QLocale::Thai
QLocale::Tibetan
QLocale::Tigrinya
QLocale::TongaLanguage
QLocale::Tsonga
QLocale::Turkish
QLocale::Turkmen
QLocale::Twi
QLocale::Uigur
QLocale::Ukrainian
QLocale::Urdu
QLocale::Uzbek
QLocale::Vietnamese
QLocale::Volapuk
QLocale::Welsh
QLocale::Wolof
QLocale::Xhosa
QLocale::Yiddish
QLocale::Yoruba
QLocale::Zhuang
QLocale::Zulu

and that's the whole lineup, ate and left no crumbs 🌈

✨ MEMBER FUNCTION DOCUMENTATION ✨

`QLocale::QLocale ()`

Constructs a QLocale object initialized with the default locale. 🎀

See also: setDefault().

`QLocale::QLocale ( const QString & name )`

Constructs a QLocale object with the specified name, which has the format "language[_country][.codeset][@modifier]" or "C", where:

language is a lowercase, two-letter, ISO 639 language code,
territory is an uppercase, two-letter, ISO 3166 country code,
and codeset and modifier are ignored. 💅

If the string violates the locale format, or language is not a valid ISO 369 code, the "C" locale is used instead. If country is not present, or is not a valid ISO 3166 code, the most appropriate country is chosen for the specified language.

The language and country codes are converted to their respective Language and Country enums. After this conversion is performed the constructor behaves exactly like QLocale(Country, Language).

heads up bestie: this constructor is much slower than QLocale(Country, Language). 😭

See also: name().

`QLocale::QLocale ( Language language, Country country = AnyCountry )`

Constructs a QLocale object with the specified language and country.

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

The language and country that are actually used can be queried using language() and country(). 🫶

See also: setDefault(), language(), and country().

`QLocale::QLocale ( const QLocale & other )`

Constructs a QLocale object as a copy of other. twin energy, we love a copy 🦋

`QLocale QLocale::c () [static]`

Returns a QLocale object initialized to the "C" locale. 💀

See also: system().

`Country QLocale::country () const`

Returns the country of this locale. 🗺️

See also: QLocale().

`QString QLocale::countryToString ( Country country ) [static]`

Returns a QString containing the name of country.

`Language QLocale::language () const`

Returns the language of this locale. 🗣️

See also: QLocale().

`QString QLocale::languageToString ( Language language ) [static]`

Returns a QString containing the name of language.

`QString QLocale::name () const`

Returns the language and country of this locale as a string of the form "language_country", where language is a lowercase, two-letter ISO 639 language code, and country is an uppercase, two-letter ISO 3166 country code. 🌸

See also: QLocale().

`QLocale & QLocale::operator= ( const QLocale & other )`

Assigns other to this QLocale object and returns a reference to this QLocale object. the way it just... hands you back a reference 😌

`void QLocale::setDefault ( const QLocale & locale ) [static]`

Warning: This function is not reentrant.

Sets the global default locale to locale. These values are used when a QLocale object is constructed with no arguments. If this function is not called, the system's locale is used.

Warning: In a multithreaded application, the default locale should be set at application startup, before any non-GUI threads are created. do not skip this step bestie, fr fr 😭

See also: system() and c().

`QLocale QLocale::system () [static]`

Returns a QLocale object initialized to the system locale. 🖥️✨

`double QLocale::toDouble ( const QString & s, bool * ok = 0 ) const`

Returns the double represented by the localized string s, or 0.0 if the conversion failed.

If ok is not 0, reports failure by setting *ok to false and success by setting *ok to true.

Unlike QString::toDouble(), this function does not fall back to the "C" locale if the string cannot be interpreted in this locale. 👀

bool ok;
double d;
QLocale c(QLocale::C);
d = c.toDouble( "1234.56", &ok );  // ok == true, d == 1234.56
d = c.toDouble( "1,234.56", &ok ); // ok == true, d == 1234.56
d = c.toDouble( "1234,56", &ok );  // ok == false
QLocale german(QLocale::German);
d = german.toDouble( "1234,56", &ok );  // ok == true, d == 1234.56
d = german.toDouble( "1.234,56", &ok ); // ok == true, d == 1234.56
d = german.toDouble( "1234.56", &ok );  // ok == false
d = german.toDouble( "1.234", &ok );    // ok == true, d == 1234.0

Notice that the last conversion returns 1234.0, because '.' is the thousands group separator in the German locale. sneaky little period 😭

This function ignores leading and trailing whitespace.

See also: toString() and QString::toDouble().

`float QLocale::toFloat ( const QString & s, bool * ok = 0 ) const`

Returns the float represented by the localized string s, or 0.0 if the conversion failed.

If ok is not 0, reports failure by setting *ok to false and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See also: toString().

`int QLocale::toInt ( const QString & s, bool * ok = 0 ) const`

Returns the int represented by the localized string s, or 0 if the conversion failed.

If ok is not 0, reports failure by setting *ok to false and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See also: toString().

`Q_LONG QLocale::toLong ( const QString & s, bool * ok = 0 ) const`

Returns the long int represented by the localized string s, or 0 if the conversion failed.

If ok is not 0, reports failure by setting *ok to false and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See also: toString().

`Q_LLONG QLocale::toLongLong ( const QString & s, bool * ok = 0 ) const`

Returns the long long int represented by the localized string s, or 0 if the conversion failed.

If ok is not 0, reports failure by setting *ok to false and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See also: toString().

`short QLocale::toShort ( const QString & s, bool * ok = 0 ) const`

Returns the short int represented by the localized string s, or 0 if the conversion failed.

If ok is not 0, reports failure by setting *ok to false and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See also: toString().