QLocale

Section: Misc. Reference Manual Pages (3qt)
Updated: 2 February 2007
Index Return to Main Contents
 

NAME

QLocale - Converts between numbers and their string representations in various languages  

SYNOPSIS

Almost all the functions in this class are reentrant when Qt is built with thread support. The exception is setDefault(). </p>

#include <qlocale.h>

 

Public Members


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 }

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 }

QLocale ()

QLocale ( const QString & name )

QLocale ( Language language, Country country = AnyCountry )

QLocale ( const QLocale & other )

QLocale & operator= ( const QLocale & other )

Language language () const

Country country () const

QString name () const

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

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

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

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

Static Public Members


QString languageToString ( Language language )

QString countryToString ( Country country )

void setDefault ( const QLocale & locale )

QLocale c ()

QLocale system ()
 

DESCRIPTION

The QLocale class converts between numbers and their string representations in various languages.

It is initialized with a country/language pair in its constructor and offers number-to-string and string-to-number conversion functions simmilar to those 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 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(). The default locale has the following effects:

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 this 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"

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

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 "C" locale is identical to English/UnitedStates.

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

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


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.

All the methods in QLocale, with the exception of setDefault(), are reentrant.

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

The double-to-string and string-to-double conversion functions are covered by the following licenses:

Copyright (c) 1991 by AT&T.

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.
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
 

QLocale::Language

This enumerated type is used to specify a language.
QLocale::C - Identical to English/UnitedStates
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
 

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).

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.  

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.  

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

Warning: This function is not reentrant.</p>

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.

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.

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().  

QString QLocale::toString ( Q_LLONG i ) const

Returns a localized string representation of i.

See also toLongLong().  

QString QLocale::toString ( short i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toShort().  

QString QLocale::toString ( ushort i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toUShort().  

QString QLocale::toString ( int i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toInt().  

QString QLocale::toString ( uint i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toUInt().  

QString QLocale::toString ( Q_LONG i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toLong().  

QString QLocale::toString ( Q_ULONG i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toULong().  

QString QLocale::toString ( Q_ULLONG i ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toULongLong().  

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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

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

See also toDouble().  

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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

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

See also toDouble().  

uint QLocale::toUInt ( const QString & s, bool * ok = 0 ) const

Returns the unsigned 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_ULONG QLocale::toULong ( const QString & s, bool * ok = 0 ) const

Returns the unsigned 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_ULLONG QLocale::toULongLong ( const QString & s, bool * ok = 0 ) const

Returns the unsigned 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().  

ushort QLocale::toUShort ( const QString & s, bool * ok = 0 ) const

Returns the unsigned 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().

 

SEE ALSO

http://doc.trolltech.com/qlocale.html http://www.trolltech.com/faq/tech.html  

COPYRIGHT

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.  

AUTHOR

Generated automatically from the source code.  

BUGS

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qlocale.3qt) and the Qt version (3.3.8).