|
Eneboo - Documentación para desarrolladores
|
|
Eneboo - Documentación para desarrolladores
|
The QLocale class converts between numbers and their string representations in various languages. Más...
#include <qlocale.h>
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.
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.
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.
| 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
| enum QLocale::Country |
| enum QLocale::Language |
| 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
| QLocale::QLocale | ( | ) |
Constructs a QLocale object initialized with the default locale.
| 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).
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().
| QLocale::QLocale | ( | ) |
| QLocale::QLocale | ( | const QString & | name | ) |
| QLocale::QLocale | ( | const QLocale & | other | ) |
| QLocale QLocale::c | ( | ) | [inline, static] |
| static QLocale QLocale::c | ( | ) | [inline, static] |
| Country QLocale::country | ( | ) | const |
| QLocale::Country QLocale::country | ( | ) | const |
Returns the country of this locale.
Returns a QString containing the name of country.
| QLocale::Language QLocale::language | ( | ) | const |
Returns the language of this locale.
| Language QLocale::language | ( | ) | const |
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.
| QString QLocale::name | ( | ) | const |
| 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.
| static void QLocale::setDefault | ( | const QLocale & | locale | ) | [static] |
| static QLocale QLocale::system | ( | ) | [static] |
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.
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.
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.
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.
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.
| QString QLocale::toString | ( | Q_ULONG | i | ) | const [inline] |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta. f and prec have the same meaning as in QString::number(double, char, int).
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta. f and prec have the same meaning as in QString::number(double, char, int).
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
| QString QLocale::toString | ( | Q_LONG | i | ) | const [inline] |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
| QString QLocale::toString | ( | Q_ULONG | i | ) | const [inline] |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
| QString QLocale::toString | ( | Q_ULLONG | i | ) | const |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
| QString QLocale::toString | ( | Q_LLONG | i | ) | const |
Returns a localized string representation of i.
| QString QLocale::toString | ( | short | i | ) | const [inline] |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta.
| QString QLocale::toString | ( | Q_LLONG | i | ) | const |
| QString QLocale::toString | ( | Q_ULLONG | i | ) | const |
| QString QLocale::toString | ( | Q_LONG | i | ) | const [inline] |
| QString QLocale::toString | ( | short | i | ) | const [inline] |
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.
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.
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.
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.
QString [friend] |
1.7.4
