TQLocale(3qt)

NAME
TQLocale - Converts between numbers and their string representations in various languages

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

#include <tqlocale.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 }
TQLocale ()
TQLocale ( const TQString & name )
TQLocale ( Language language, Country country = AnyCountry )
TQLocale ( const TQLocale & other )
TQLocale & operator= ( const TQLocale & other )
Language language () const
Country country () const
TQString name () const
short toShort ( const TQString & s, bool * ok = 0 ) const
ushort toUShort ( const TQString & s, bool * ok = 0 ) const
int toInt ( const TQString & s, bool * ok = 0 ) const
uint toUInt ( const TQString & s, bool * ok = 0 ) const
TQ_LONG toLong ( const TQString & s, bool * ok = 0 ) const
TQ_ULONG toULong ( const TQString & s, bool * ok = 0 ) const
TQ_LLONG toLongLong ( const TQString & s, bool * ok = 0 ) const
TQ_ULLONG toULongLong ( const TQString & s, bool * ok = 0 ) const
float toFloat ( const TQString & s, bool * ok = 0 ) const
double toDouble ( const TQString & s, bool * ok = 0 ) const
TQString toString ( short i ) const
TQString toString ( ushort i ) const
TQString toString ( int i ) const
TQString toString ( uint i ) const
TQString toString ( TQ_LONG i ) const
TQString toString ( TQ_ULONG i ) const
TQString toString ( TQ_LLONG i ) const
TQString toString ( TQ_ULLONG i ) const
TQString toString ( float i, char f = 'g', int prec = 6 ) const
TQString toString ( double i, char f = 'g', int prec = 6 ) const

  Static Public Members
TQString languageToString ( Language language )
TQString countryToString ( Country country )
void setDefault ( const TQLocale & locale )
TQLocale c ()
TQLocale system ()

DESCRIPTION
The TQLocale 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 TQString.

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

TQLocale 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 TQLocale object is constructed with the default constructor, it will use the default locale's settings.

TQString::toDouble() interprets the string according to the default locale. If this fails, it falls back on the "C" locale.

TQString::arg() uses the default locale to format a number when its position specifier in the format string contains an 'L', e.g. "%L1".

    TQLocale::setDefault(TQLocale(TQLocale::Hebrew, TQLocale::Israel));
    TQLocale hebrew; // Constructs a default TQLocale
    TQString s1 = hebrew.toString(15714.3, 'e');
    bool ok;
    double d;
    TQLocale::setDefault(TQLocale::C);
    d = TQString( "1234,56" ).toDouble(&ok); // ok == false
    d = TQString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
    TQLocale::setDefault(TQLocale::German);
    d = TQString( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
    d = TQString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
    TQLocale::setDefault(TQLocale(TQLocale::English, TQLocale::UnitedStates));
    str = TQString( "%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, TQLocale 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 TQLocale object is by specifying the locale name.

    TQLocale korean("ko");
    TQLocale 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 TQLocale, with the exception of setDefault(), are reentrant.

See also TQString::toDouble(), TQString::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

TQLocale::Country
This enumerated type is used to specify a country.

TQLocale::AnyCountry

TQLocale::Afghanistan

TQLocale::Albania

TQLocale::Algeria

TQLocale::AmericanSamoa

TQLocale::Andorra

TQLocale::Angola

TQLocale::Anguilla

TQLocale::Antarctica

TQLocale::AntiguaAndBarbuda

TQLocale::Argentina

TQLocale::Armenia

TQLocale::Aruba

TQLocale::Australia

TQLocale::Austria

TQLocale::Azerbaijan

TQLocale::Bahamas

TQLocale::Bahrain

TQLocale::Bangladesh

TQLocale::Barbados

TQLocale::Belarus

TQLocale::Belgium

TQLocale::Belize

TQLocale::Benin

TQLocale::Bermuda

TQLocale::Bhutan

TQLocale::Bolivia

TQLocale::BosniaAndHerzegowina

TQLocale::Botswana

TQLocale::BouvetIsland

TQLocale::Brazil

TQLocale::BritishIndianOceanTerritory

TQLocale::BruneiDarussalam

TQLocale::Bulgaria

TQLocale::BurkinaFaso

TQLocale::Burundi

TQLocale::Cambodia

TQLocale::Cameroon

TQLocale::Canada

TQLocale::CapeVerde

TQLocale::CaymanIslands

TQLocale::CentralAfricanRepublic

TQLocale::Chad

TQLocale::Chile

TQLocale::China

TQLocale::ChristmasIsland

TQLocale::CocosIslands

TQLocale::Colombia

TQLocale::Comoros

TQLocale::DemocraticRepublicOfCongo

TQLocale::PeoplesRepublicOfCongo

TQLocale::CookIslands

TQLocale::CostaRica

TQLocale::IvoryCoast

TQLocale::Croatia

TQLocale::Cuba

TQLocale::Cyprus

TQLocale::CzechRepublic

TQLocale::Denmark

TQLocale::Djibouti

TQLocale::Dominica

TQLocale::DominicanRepublic

TQLocale::EastTimor

TQLocale::Ecuador

TQLocale::Egypt

TQLocale::ElSalvador

TQLocale::EquatorialGuinea

TQLocale::Eritrea

TQLocale::Estonia

TQLocale::Ethiopia

TQLocale::FalklandIslands

TQLocale::FaroeIslands

TQLocale::FijiCountry

TQLocale::Finland

TQLocale::France

TQLocale::MetropolitanFrance

TQLocale::FrenchGuiana

TQLocale::FrenchPolynesia

TQLocale::FrenchSouthernTerritories

TQLocale::Gabon

TQLocale::Gambia

TQLocale::Georgia

TQLocale::Germany

TQLocale::Ghana

TQLocale::Gibraltar

TQLocale::Greece

TQLocale::Greenland

TQLocale::Grenada

TQLocale::Guadeloupe

TQLocale::Guam

TQLocale::Guatemala

TQLocale::Guinea

TQLocale::GuineaBissau

TQLocale::Guyana

TQLocale::Haiti

TQLocale::HeardAndMcDonaldIslands

TQLocale::Honduras

TQLocale::HongKong

TQLocale::Hungary

TQLocale::Iceland

TQLocale::India

TQLocale::Indonesia

TQLocale::Iran

TQLocale::Iraq

TQLocale::Ireland

TQLocale::Israel

TQLocale::Italy

TQLocale::Jamaica

TQLocale::Japan

TQLocale::Jordan

TQLocale::Kazakhstan

TQLocale::Kenya

TQLocale::Kiribati

TQLocale::DemocraticRepublicOfKorea

TQLocale::RepublicOfKorea

TQLocale::Kuwait

TQLocale::Kyrgyzstan

TQLocale::Lao

TQLocale::Latvia

TQLocale::Lebanon

TQLocale::Lesotho

TQLocale::Liberia

TQLocale::LibyanArabJamahiriya

TQLocale::Liechtenstein

TQLocale::Lithuania

TQLocale::Luxembourg

TQLocale::Macau

TQLocale::Macedonia

TQLocale::Madagascar

TQLocale::Malawi

TQLocale::Malaysia

TQLocale::Maldives

TQLocale::Mali

TQLocale::Malta

TQLocale::MarshallIslands

TQLocale::Martinique

TQLocale::Mauritania

TQLocale::Mauritius

TQLocale::Mayotte

TQLocale::Mexico

TQLocale::Micronesia

TQLocale::Moldova

TQLocale::Monaco

TQLocale::Mongolia

TQLocale::Montserrat

TQLocale::Morocco

TQLocale::Mozambique

TQLocale::Myanmar

TQLocale::Namibia

TQLocale::NauruCountry

TQLocale::Nepal

TQLocale::Netherlands

TQLocale::NetherlandsAntilles

TQLocale::NewCaledonia

TQLocale::NewZealand

TQLocale::Nicaragua

TQLocale::Niger

TQLocale::Nigeria

TQLocale::Niue

TQLocale::NorfolkIsland

TQLocale::NorthernMarianaIslands

TQLocale::Norway

TQLocale::Oman

TQLocale::Pakistan

TQLocale::Palau

TQLocale::PalestinianTerritory

TQLocale::Panama

TQLocale::PapuaNewGuinea

TQLocale::Paraguay

TQLocale::Peru

TQLocale::Philippines

TQLocale::Pitcairn

TQLocale::Poland

TQLocale::Portugal

TQLocale::PuertoRico

TQLocale::Qatar

TQLocale::Reunion

TQLocale::Romania

TQLocale::RussianFederation

TQLocale::Rwanda

TQLocale::SaintKittsAndNevis

TQLocale::StLucia

TQLocale::StVincentAndTheGrenadines

TQLocale::Samoa

TQLocale::SanMarino

TQLocale::SaoTomeAndPrincipe

TQLocale::SaudiArabia

TQLocale::Senegal

TQLocale::Seychelles

TQLocale::SierraLeone

TQLocale::Singapore

TQLocale::Slovakia

TQLocale::Slovenia

TQLocale::SolomonIslands

TQLocale::Somalia

TQLocale::SouthAfrica

TQLocale::SouthGeorgiaAndTheSouthSandwichIslands

TQLocale::Spain

TQLocale::SriLanka

TQLocale::StHelena

TQLocale::StPierreAndMiquelon

TQLocale::Sudan

TQLocale::Suriname

TQLocale::SvalbardAndJanMayenIslands

TQLocale::Swaziland

TQLocale::Sweden

TQLocale::Switzerland

TQLocale::SyrianArabRepublic

TQLocale::Taiwan

TQLocale::Tajikistan

TQLocale::Tanzania

TQLocale::Thailand

TQLocale::Togo

TQLocale::Tokelau

TQLocale::TongaCountry

TQLocale::TrinidadAndTobago

TQLocale::Tunisia

TQLocale::Turkey

TQLocale::Turkmenistan

TQLocale::TurksAndCaicosIslands

TQLocale::Tuvalu

TQLocale::Uganda

TQLocale::Ukraine

TQLocale::UnitedArabEmirates

TQLocale::UnitedKingdom

TQLocale::UnitedStates

TQLocale::UnitedStatesMinorOutlyingIslands

TQLocale::Uruguay

TQLocale::Uzbekistan

TQLocale::Vanuatu

TQLocale::VaticanCityState

TQLocale::Venezuela

TQLocale::VietNam

TQLocale::BritishVirginIslands

TQLocale::USVirginIslands

TQLocale::WallisAndFutunaIslands

TQLocale::WesternSahara

TQLocale::Yemen

TQLocale::Yugoslavia

TQLocale::Zambia

TQLocale::Zimbabwe

TQLocale::Language
This enumerated type is used to specify a language.

TQLocale::C - Identical to English/UnitedStates

TQLocale::Abkhazian

TQLocale::Afan

TQLocale::Afar

TQLocale::Afrikaans

TQLocale::Albanian

TQLocale::Amharic

TQLocale::Arabic

TQLocale::Armenian

TQLocale::Assamese

TQLocale::Aymara

TQLocale::Azerbaijani

TQLocale::Bashkir

TQLocale::Basque

TQLocale::Bengali

TQLocale::Bhutani

TQLocale::Bihari

TQLocale::Bislama

TQLocale::Breton

TQLocale::Bulgarian

TQLocale::Burmese

TQLocale::Byelorussian

TQLocale::Cambodian

TQLocale::Catalan

TQLocale::Chinese

TQLocale::Corsican

TQLocale::Croatian

TQLocale::Czech

TQLocale::Danish

TQLocale::Dutch

TQLocale::English

TQLocale::Esperanto

TQLocale::Estonian

TQLocale::Faroese

TQLocale::FijiLanguage

TQLocale::Finnish

TQLocale::French

TQLocale::Frisian

TQLocale::Gaelic

TQLocale::Galician

TQLocale::Georgian

TQLocale::German

TQLocale::Greek

TQLocale::Greenlandic

TQLocale::Guarani

TQLocale::Gujarati

TQLocale::Hausa

TQLocale::Hebrew

TQLocale::Hindi

TQLocale::Hungarian

TQLocale::Icelandic

TQLocale::Indonesian

TQLocale::Interlingua

TQLocale::Interlingue

TQLocale::Inuktitut

TQLocale::Inupiak

TQLocale::Irish

TQLocale::Italian

TQLocale::Japanese

TQLocale::Javanese

TQLocale::Kannada

TQLocale::Kashmiri

TQLocale::Kazakh

TQLocale::Kinyarwanda

TQLocale::Kirghiz

TQLocale::Korean

TQLocale::Kurdish

TQLocale::Kurundi

TQLocale::Laothian

TQLocale::Latin

TQLocale::Latvian

TQLocale::Lingala

TQLocale::Lithuanian

TQLocale::Macedonian

TQLocale::Malagasy

TQLocale::Malay

TQLocale::Malayalam

TQLocale::Maltese

TQLocale::Maori

TQLocale::Marathi

TQLocale::Moldavian

TQLocale::Mongolian

TQLocale::NauruLanguage

TQLocale::Nepali

TQLocale::Norwegian

TQLocale::Occitan

TQLocale::Oriya

TQLocale::Pashto

TQLocale::Persian

TQLocale::Polish

TQLocale::Portuguese

TQLocale::Punjabi

TQLocale::Quechua

TQLocale::RhaetoRomance

TQLocale::Romanian

TQLocale::Russian

TQLocale::Samoan

TQLocale::Sangho

TQLocale::Sanskrit

TQLocale::Serbian

TQLocale::SerboCroatian

TQLocale::Sesotho

TQLocale::Setswana

TQLocale::Shona

TQLocale::Sindhi

TQLocale::Singhalese

TQLocale::Siswati

TQLocale::Slovak

TQLocale::Slovenian

TQLocale::Somali

TQLocale::Spanish

TQLocale::Sundanese

TQLocale::Swahili

TQLocale::Swedish

TQLocale::Tagalog

TQLocale::Tajik

TQLocale::Tamil

TQLocale::Tatar

TQLocale::Telugu

TQLocale::Thai

TQLocale::Tibetan

TQLocale::Tigrinya

TQLocale::TongaLanguage

TQLocale::Tsonga

TQLocale::Turkish

TQLocale::Turkmen

TQLocale::Twi

TQLocale::Uigur

TQLocale::Ukrainian

TQLocale::Urdu

TQLocale::Uzbek

TQLocale::Vietnamese

TQLocale::Volapuk

TQLocale::Welsh

TQLocale::Wolof

TQLocale::Xhosa

TQLocale::Yiddish

TQLocale::Yoruba

TQLocale::Zhuang

TQLocale::Zulu

MEMBER FUNCTION DOCUMENTATION

TQLocale::TQLocale ()
Constructs a TQLocale object initialized with the default locale.

See also setDefault().

TQLocale::TQLocale ( const TQString & name )
Constructs a TQLocale 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 TQLocale(Country, Language).

This constructor is much slower than TQLocale(Country, Language).

See also name().

TQLocale::TQLocale ( Language language, Country country = AnyCountry )
Constructs a TQLocale 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, TQLocale 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().

TQLocale::TQLocale ( const TQLocale & other )
Constructs a TQLocale object as a copy of other.

TQLocale TQLocale::c () [static]
Returns a TQLocale object initialized to the "C" locale.

See also system().

Country TQLocale::country () const
Returns the country of this locale.

See also TQLocale().

TQString TQLocale::countryToString ( Country country ) [static]
Returns a TQString containing the name of country.

Language TQLocale::language () const
Returns the language of this locale.

See also TQLocale().

TQString TQLocale::languageToString ( Language language ) [static]
Returns a TQString containing the name of language.

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

TQLocale & TQLocale::operator= ( const TQLocale & other )
Assigns other to this TQLocale object and returns a reference to this TQLocale object.

void TQLocale::setDefault ( const TQLocale & locale ) [static]
Warning: This function is not reentrant.</p>

Sets the global default locale to locale. These values are used when a TQLocale 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().

TQLocale TQLocale::system () [static]
Returns a TQLocale object initialized to the system locale.

double TQLocale::toDouble ( const TQString & 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 TQString::toDouble(), this function does not fall back to the "C" locale if the string cannot be interpreted in this locale.

        bool ok;
        double d;
        TQLocale c(TQLocale::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
        TQLocale german(TQLocale::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 TQString::toDouble().

float TQLocale::toFloat ( const TQString & 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 TQLocale::toInt ( const TQString & 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().

TQ_LONG TQLocale::toLong ( const TQString & 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().

TQ_LLONG TQLocale::toLongLong ( const TQString & 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 TQLocale::toShort ( const TQString & 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().

TQString TQLocale::toString ( TQ_LLONG i ) const
Returns a localized string representation of i.

See also toLongLong().

TQString TQLocale::toString ( short i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toShort().

TQString TQLocale::toString ( ushort i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toUShort().

TQString TQLocale::toString ( int i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toInt().

TQString TQLocale::toString ( uint i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toUInt().

TQString TQLocale::toString ( TQ_LONG i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toLong().

TQString TQLocale::toString ( TQ_ULONG i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toULong().

TQString TQLocale::toString ( TQ_ULLONG i ) const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

See also toULongLong().

TQString TQLocale::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 TQString::number(double, char, int).

See also toDouble().

TQString TQLocale::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 TQString::number(double, char, int).

See also toDouble().

uint TQLocale::toUInt ( const TQString & 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().

TQ_ULONG TQLocale::toULong ( const TQString & 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().

TQ_ULLONG TQLocale::toULongLong ( const TQString & 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 TQLocale::toUShort ( const TQString & 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/tqlocale.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 TQt documentation is provided in HTML format; it is located at $TQTDIR/doc/html and can be read using TQt 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 (tqlocale.3qt) and the Qt version (3.3.8).