Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages

QLocale Class Reference

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

#include </home/clem/local/src/opie/qmake/include/qlocale.h>

Collaboration diagram for QLocale:

Collaboration graph
[legend]
List of all members.

Public Types

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
}

Public Member Functions

 QLocale ()
 QLocale (const QString &name)
 QLocale (Language language, Country country=AnyCountry)
 QLocale (const QLocale &other)
QLocaleoperator= (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 Member Functions

static QString languageToString (Language language)
static QString countryToString (Country country)
static void setDefault (const QLocale &locale)
static QLocale c ()
static QLocale system ()

Private Attributes

const QLocalePrivated

Static Private Attributes

static const QLocalePrivatedefault_d = 0

Friends

class QString

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

Definition at line 43 of file qlocale.h.


Member Enumeration Documentation

enum QLocale::Country
 

This enumerated type is used to specify a country.

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

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

Definition at line 192 of file qlocale.h.

enum QLocale::Language
 

This enumerated type is used to specify a language.

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

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

Definition at line 48 of file qlocale.h.


Constructor & Destructor Documentation

QLocale::QLocale  ) 
 

Constructs a QLocale object initialized with the default locale.

See also:
setDefault()

Definition at line 2303 of file qlocale.cpp.

References d, default_d, and system().

Referenced by system().

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

Definition at line 2259 of file qlocale.cpp.

References AnyCountry, C, codeToCountry(), codeToLanguage(), d, findLocale(), and l.

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

Definition at line 2330 of file qlocale.cpp.

References C, d, default_d, findLocale(), QLocalePrivate::languageId(), and system().

QLocale::QLocale const QLocale other  ) 
 

Constructs a QLocale object as a copy of other.

Definition at line 2347 of file qlocale.cpp.

References d.


Member Function Documentation

QLocale QLocale::c  )  [inline, static]
 

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

See also:
system()

Definition at line 483 of file qlocale.h.

Referenced by name().

QLocale::Country QLocale::country void   )  const
 

Returns the country of this locale.

See also:
QLocale()

Definition at line 2398 of file qlocale.cpp.

References QLocalePrivate::countryId(), and d.

Referenced by name().

QString QLocale::countryToString Country  country  )  [static]
 

Returns a QString containing the name of country.

Definition at line 2446 of file qlocale.cpp.

References country_name_index, country_name_list, and LastCountry.

QLocale::Language QLocale::language  )  const
 

Returns the language of this locale.

See also:
QLocale()

Definition at line 2388 of file qlocale.cpp.

References d, and QLocalePrivate::languageId().

Referenced by name().

QString QLocale::languageToString Language  language  )  [static]
 

Returns a QString containing the name of language.

Definition at line 2435 of file qlocale.cpp.

References language_name_index, language_name_list, and LastLanguage.

QString QLocale::name void   )  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()

Definition at line 2412 of file qlocale.cpp.

References AnyCountry, QString::append(), c(), C, country(), countryToCode(), l, language(), and languageToCode().

QLocale & QLocale::operator= const QLocale other  ) 
 

Assigns other to this QLocale object and returns a reference to this QLocale object.

Definition at line 2357 of file qlocale.cpp.

References d.

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

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

Definition at line 2378 of file qlocale.cpp.

References d, and default_d.

QLocale QLocale::system  )  [static]
 

Returns a QLocale object initialized to the system locale.

Definition at line 2767 of file qlocale.cpp.

References QLocale(), s, and QLocalePrivate::systemLocaleName().

Referenced by QLocale().

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() QString::toDouble()

Definition at line 2680 of file qlocale.cpp.

References d, QLocalePrivate::ParseGroupSeparators, and QLocalePrivate::stringToDouble().

Referenced by toFloat().

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

Definition at line 2639 of file qlocale.cpp.

References toDouble().

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

Definition at line 2511 of file qlocale.cpp.

References i, and toLongLong().

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

Definition at line 2557 of file qlocale.cpp.

References i, and toLongLong().

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

Definition at line 2604 of file qlocale.cpp.

References d, QLocalePrivate::ParseGroupSeparators, and QLocalePrivate::stringToLongLong().

Referenced by toInt(), toLong(), and toShort().

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

Definition at line 2465 of file qlocale.cpp.

References i, and toLongLong().

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. f and prec have the same meaning as in QString::number(double, char, int).

See also:
toDouble()

Definition at line 2728 of file qlocale.cpp.

References QLocalePrivate::CapitalEorX, d, QLocalePrivate::DFDecimal, QLocalePrivate::DFExponent, QLocalePrivate::DFSignificantDigits, QLocalePrivate::doubleToString(), flags, qIsUpper(), qToLower(), and QLocalePrivate::ThousandsGroup.

QString QLocale::toString float  i,
char  f = 'g',
int  prec = 6
const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. f and prec have the same meaning as in QString::number(double, char, int).

See also:
toDouble()

Definition at line 475 of file qlocale.h.

References f.

QString QLocale::toString Q_ULLONG  i  )  const
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toULongLong()

Definition at line 2702 of file qlocale.cpp.

References d, QLocalePrivate::ThousandsGroup, and QLocalePrivate::unsLongLongToString().

QString QLocale::toString Q_LLONG  i  )  const
 

Returns a localized string representation of i.

See also:
toLongLong()

Definition at line 2691 of file qlocale.cpp.

References d, QLocalePrivate::longLongToString(), and QLocalePrivate::ThousandsGroup.

QString QLocale::toString Q_ULONG  i  )  const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toULong()

Definition at line 470 of file qlocale.h.

QString QLocale::toString Q_LONG  i  )  const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toLong()

Definition at line 468 of file qlocale.h.

QString QLocale::toString uint  i  )  const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toUInt()

Definition at line 465 of file qlocale.h.

QString QLocale::toString int  i  )  const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toInt()

Definition at line 463 of file qlocale.h.

QString QLocale::toString ushort  i  )  const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toUShort()

Definition at line 461 of file qlocale.h.

QString QLocale::toString short  i  )  const [inline]
 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also:
toShort()

Definition at line 459 of file qlocale.h.

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

Definition at line 2534 of file qlocale.cpp.

References i, and toULongLong().

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

Definition at line 2580 of file qlocale.cpp.

References i, and toULongLong().

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

Definition at line 2622 of file qlocale.cpp.

References d, QLocalePrivate::ParseGroupSeparators, and QLocalePrivate::stringToUnsLongLong().

Referenced by toUInt(), toULong(), and toUShort().

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

Definition at line 2488 of file qlocale.cpp.

References i, and toULongLong().


Friends And Related Function Documentation

friend class QString [friend]
 

Definition at line 45 of file qlocale.h.


Member Data Documentation

const QLocalePrivate* QLocale::d [private]
 

Definition at line 487 of file qlocale.h.

Referenced by country(), language(), operator=(), QLocale(), setDefault(), toDouble(), toLongLong(), toString(), and toULongLong().

const QLocalePrivate * QLocale::default_d = 0 [static, private]
 

Definition at line 1633 of file qlocale.cpp.

Referenced by QLocale(), and setDefault().


The documentation for this class was generated from the following files:
Generated on Sat Nov 5 17:47:44 2005 for OPIE by  doxygen 1.4.2