KLocale Class Reference
class for supporting locale settings and national language More...
#include <klocale.h>
Public Types | |
enum | SignPosition { ParensAround = 0, BeforeQuantityMoney = 1, AfterQuantityMoney = 2, BeforeMoney = 3, AfterMoney = 4 } |
enum | ReadDateFlags { NormalFormat = 1, ShortFormat = 2 } |
enum | ReadTimeFlags { WithSeconds = 0, WithoutSeconds = 1 } |
enum | MeasureSystem { Metric, Imperial } |
Public Member Functions | |
KLocale (const QString &catalog, KConfig *config=0) | |
KLocale (const KLocale &rhs) | |
KLocale & | operator= (const KLocale &rhs) |
~KLocale () | |
QString | translate (const char *index) const |
QString | translate (const char *comment, const char *fallback) const |
QString | translate (const char *singular, const char *plural, unsigned long n) const |
bool | setEncoding (int mibEnum) |
bool | setLanguage (const QString &language) |
bool | setLanguage (const QStringList &languages) |
bool | setCountry (const QString &country) |
QString | decimalSymbol () const |
QString | thousandsSeparator () const |
QString | currencySymbol () const |
QString | monetaryDecimalSymbol () const |
QString | monetaryThousandsSeparator () const |
QString | positiveSign () const |
QString | negativeSign () const |
int | fracDigits () const |
bool | positivePrefixCurrencySymbol () const |
bool | negativePrefixCurrencySymbol () const |
SignPosition | positiveMonetarySignPosition () const |
SignPosition | negativeMonetarySignPosition () const |
QString | formatMoney (double num, const QString ¤cy=QString::null, int digits=-1) const |
QString | formatNumber (double num, int precision=-1) const |
QString | formatLong (long num) const |
bool | nounDeclension () const |
QString | formatDate (const QDate &pDate, bool shortFormat=false) const |
bool | dateMonthNamePossessive () const |
QString | formatTime (const QTime &pTime, bool includeSecs, bool isDuration) const |
QString | formatTime (const QTime &pTime, bool includeSecs=false) const |
bool | use12Clock () const |
bool | weekStartsMonday () const KDE_DEPRECATED |
int | weekStartDay () const |
QString | monthName (int i, bool shortName=false) const KDE_DEPRECATED |
QString | monthNamePossessive (int i, bool shortName=false) const KDE_DEPRECATED |
QString | weekDayName (int i, bool shortName=false) const KDE_DEPRECATED |
const KCalendarSystem * | calendar () const |
QString | calendarType () const |
void | setCalendar (const QString &calendarType) |
QString | formatDateTime (const QDateTime &pDateTime, bool shortFormat=true, bool includeSecs=false) const |
double | readMoney (const QString &numStr, bool *ok=0) const |
double | readNumber (const QString &numStr, bool *ok=0) const |
QDate | readDate (const QString &str, bool *ok=0) const |
QDate | readDate (const QString &intstr, const QString &fmt, bool *ok=0) const |
QDate | readDate (const QString &str, ReadDateFlags flags, bool *ok=0) const |
QTime | readTime (const QString &str, bool *ok=0) const |
QTime | readTime (const QString &str, ReadTimeFlags flags, bool *ok=0) const |
QString | language () const |
QString | country () const |
QStringList | languagesTwoAlpha () const |
QStringList | languageList () const |
const char * | encoding () const |
int | encodingMib () const |
QTextCodec * | codecForEncoding () const |
int | fileEncodingMib () const |
void | setDateFormat (const QString &format) |
void | setDateFormatShort (const QString &format) |
void | setDateMonthNamePossessive (bool possessive) |
void | setTimeFormat (const QString &format) |
void | setWeekStartsMonday (bool start) KDE_DEPRECATED |
void | setWeekStartDay (int day) |
QString | dateFormat () const |
QString | dateFormatShort () const |
QString | timeFormat () const |
void | setDecimalSymbol (const QString &symbol) |
void | setThousandsSeparator (const QString &separator) |
void | setPositiveSign (const QString &sign) |
void | setNegativeSign (const QString &sign) |
void | setPositiveMonetarySignPosition (SignPosition signpos) |
void | setNegativeMonetarySignPosition (SignPosition signpos) |
void | setPositivePrefixCurrencySymbol (bool prefix) |
void | setNegativePrefixCurrencySymbol (bool prefix) |
void | setFracDigits (int digits) |
void | setMonetaryThousandsSeparator (const QString &separator) |
void | setMonetaryDecimalSymbol (const QString &symbol) |
void | setCurrencySymbol (const QString &symbol) |
int | pageSize () const |
void | setPageSize (int paperFormat) |
MeasureSystem | measureSystem () const |
void | setMeasureSystem (MeasureSystem value) |
void | insertCatalogue (const QString &catalog) |
void | removeCatalogue (const QString &catalog) |
void | setActiveCatalogue (const QString &catalog) |
QString | translateQt (const char *context, const char *sourceText, const char *message) const |
QStringList | allLanguagesTwoAlpha () const |
QString | twoAlphaToLanguageName (const QString &code) const |
QStringList | allCountriesTwoAlpha () const |
QString | twoAlphaToCountryName (const QString &code) const |
Static Public Member Functions | |
static void | splitLocale (const QString &str, QString &language, QString &country, QString &charset) |
static void | setMainCatalogue (const char *catalog) |
static QString | langLookup (const QString &fname, const char *rtype="html") |
static QString | defaultLanguage () |
static QString | defaultCountry () |
static QString | _initLanguage (KConfigBase *config) |
Static Protected Member Functions | |
static void | initInstance () |
Friends | |
class | KGlobal |
Related Functions | |
(Note that these are not member functions.) | |
I18N_NOOP (x) | |
I18N_NOOP2 (comment, x) | |
KDECORE_EXPORT QString | i18n (const char *text) |
KDECORE_EXPORT QString | i18n (const char *comment, const char *text) |
KDECORE_EXPORT QString | i18n (const char *singular, const char *plural, unsigned long n) |
QString | tr2i18n (const char *message, const char *=0) |
Detailed Description
class for supporting locale settings and national languageKLocale provides support for country specific stuff like the national language.
KLocale supports translating, as well as specifying the format for numbers, currency, time, and date.
- Author:
- Stephan Kulow <coolo@kde.org>, Preston Brown <pbrown@kde.org>, Hans Petter Bieker <bieker@kde.org>, Lukas Tinkl <lukas.tinkl@suse.cz>
Definition at line 119 of file klocale.h.
Member Enumeration Documentation
|
Various positions for where to place the positive or negative sign when they are related to a monetary value.
|
|
The Metric system will give you information in mm, while the Imperial system will give you information in inches.
|
Constructor & Destructor Documentation
|
Constructs a KLocale with the given catalog name. The constructor looks for an entry Locale/Language in the configuration file. If no config file is specified, it will also look for languages using the environment variables (KDE_LANG, LC_MESSAGES, LC_ALL, LANG), as well as the global configuration file. If KLocale is not able to use any of the specified languages, the default language (en_US) will be used. If you specify a configuration file, it has to be valid until the KLocale object is destroyed.
Definition at line 76 of file klocale.cpp. References KInstance::config(), and KGlobal::instance(). Referenced by initInstance(). |
|
Copy constructor.
Definition at line 2268 of file klocale.cpp. |
|
Destructor.
Definition at line 696 of file klocale.cpp. |
Member Function Documentation
|
Assignment operator.
Definition at line 2275 of file klocale.cpp. References d, m_country, m_currencySymbol, m_dateFormat, m_dateFormatShort, m_decimalSymbol, m_fracDigits, m_language, m_monetaryDecimalSymbol, m_monetaryThousandsSeparator, m_negativeMonetarySignPosition, m_negativePrefixCurrencySymbol, m_negativeSign, m_positiveMonetarySignPosition, m_positivePrefixCurrencySymbol, m_positiveSign, m_thousandsSeparator, and m_timeFormat. |
|
Translates the string into the corresponding string in the national language, if available. If not, returns the string itself. There is a KDE wide message file that contains the most often used phrases, so we can avoid duplicating the translation of these phrases. If a phrase is not found in the catalog given to the constructor, it will search in the system catalog. This makes it possible to override some phrases for your needs. The argument must be an UTF-8 encoded string (If you only use characters that are in US-ASCII you're on the safe side. But for e.g. german umlauts or french accents should be recoded to UTF-8)
Definition at line 753 of file klocale.cpp. Referenced by formatDateTime(), formatTime(), i18n(), monthName(), KCalendarSystemJalali::monthName(), KCalendarSystemHijri::monthName(), KCalendarSystemHebrew::monthName(), KCalendarSystemGregorian::monthName(), monthNamePossessive(), KCalendarSystemHijri::monthNamePossessive(), KCalendarSystemGregorian::monthNamePossessive(), readTime(), KCalendarSystemJalali::weekDayName(), KCalendarSystemHijri::weekDayName(), and KCalendarSystem::weekDayName(). |
|
Translates the string into the corresponding string in the national language, if available. The real contents of the string is in the argument fallback, but the meaning of it is coded into the argument index. In some cases you'll need this function, when english is too ambiguous to express it. Most of the times the translators will tell you if it can't be translated as it, but think of cases as "New", where the translations differs depending on what is New. Or simple cases as "Open", that can be used to express something is open or it can be used to express that you want something to open... There are tons of such examples. If translate("Open") is not enough to translate it well, use translate("To Open", "Open") or translate("Is Open", "Open"). The english user will see "Open" in both cases, but the translated version may vary. Of course you can also use i18n()
Definition at line 758 of file klocale.cpp. References endl(), QString::fromUtf8(), and kdDebug(). |
|
Used to get the correct, translated singular or plural of a word.
Definition at line 794 of file klocale.cpp. References endl(), QString::find(), QString::fromUtf8(), QString::isEmpty(), kdDebug(), kdFatal(), kdWarning(), and QStringList::split(). |
|
Changes the current encoding.
Definition at line 2149 of file klocale.cpp. References QTextCodec::codecForMib(). |
|
Changes the current language. The current language will be left unchanged if failed. It will force a reload of the country specific configuration as well.
Definition at line 405 of file klocale.cpp. |
|
Changes the list of prefed languages for the locale. The first valid language in the list will be used, or the default (en_US) language will be used if non of the specified languages were available.
Definition at line 423 of file klocale.cpp. References defaultLanguage(), and languageList(). |
|
Changes the current country. The current country will be left unchanged if failed. It will force a reload of the country specific configuration.
Definition at line 382 of file klocale.cpp. References QString::isEmpty(). |
|
Returns what a decimal point should look like (". " or "," etc.) according to the current locale or user settings.
Definition at line 1022 of file klocale.cpp. Referenced by formatNumber(), and readNumber(). |
|
Returns what the thousands separator should look like ("," or ". " etc.) according to the current locale or user settings.
Definition at line 1028 of file klocale.cpp. Referenced by formatNumber(), and readNumber(). |
|
Returns what the symbol denoting currency in the current locale as as defined by user settings should look like.
Definition at line 1034 of file klocale.cpp. Referenced by formatMoney(), and readMoney(). |
|
Returns what a decimal point should look like (". " or "," etc.) for monetary values, according to the current locale or user settings.
Definition at line 1040 of file klocale.cpp. Referenced by formatMoney(), and readMoney(). |
|
Returns what a thousands separator for monetary values should look like ("," or " " etc. ) according to the current locale or user settings.
Definition at line 1046 of file klocale.cpp. Referenced by formatMoney(), and readMoney(). |
|
Returns what a positive sign should look like ("+", " ", etc. ) according to the current locale or user settings.
Definition at line 1052 of file klocale.cpp. Referenced by formatMoney(), and formatNumber(). |
|
Returns what a negative sign should look like ("-", etc. ) according to the current locale or user settings.
Definition at line 1058 of file klocale.cpp. Referenced by formatMoney(), formatNumber(), readMoney(), and readNumber(). |
|
The number of fractional digits to include in numeric/monetary values (usually 2).
Definition at line 1064 of file klocale.cpp. Referenced by formatMoney(). |
|
If and only if the currency symbol precedes a positive value, this will be true.
Definition at line 1070 of file klocale.cpp. Referenced by formatMoney(). |
|
If and only if the currency symbol precedes a negative value, this will be true.
Definition at line 1076 of file klocale.cpp. Referenced by formatMoney(). |
|
Returns the position of a positive sign in relation to a monetary value.
Definition at line 1082 of file klocale.cpp. Referenced by formatMoney(). |
|
Denotes where to place a negative sign in relation to a monetary value.
Definition at line 1088 of file klocale.cpp. Referenced by formatMoney(), and readMoney(). |
|
Given a double, converts that to a numeric string containing the localized monetary equivalent. e.g. given 123456, return "$ 123,456.00".
Definition at line 1106 of file klocale.cpp. References QString::append(), currencySymbol(), QString::find(), fracDigits(), QString::insert(), QString::isNull(), QString::length(), monetaryDecimalSymbol(), monetaryThousandsSeparator(), negativeMonetarySignPosition(), negativePrefixCurrencySymbol(), negativeSign(), QString::number(), positiveMonetarySignPosition(), positivePrefixCurrencySymbol(), positiveSign(), QString::prepend(), and QString::replace(). |
|
Given a double, converts that to a numeric string containing the localized numeric equivalent. e.g. given 123456.78F, return "123,456.78" (for some European country). If precision isn't specified, 2 is used.
Definition at line 1172 of file klocale.cpp. References decimalSymbol(), QString::find(), QString::insert(), QString::length(), negativeSign(), QString::number(), positiveSign(), QString::prepend(), QString::replace(), and thousandsSeparator(). Referenced by formatLong(). |
|
Given an integer, converts that to a numeric string containing the localized numeric equivalent. e.g. given 123456L, return "123,456" (for some European country).
Definition at line 1190 of file klocale.cpp. References formatNumber(). |
|
Use this to determine whether nouns are declined in locale's language. This property should remain read-only (no setter function)
Definition at line 998 of file klocale.cpp. |
|
Returns a string formatted to the current locale's conventions regarding dates.
Definition at line 1200 of file klocale.cpp. References QString::append(), QString::at(), calendar(), dateFormat(), dateFormatShort(), QDate::isValid(), QString::length(), KCalendarSystem::month(), monthName(), monthNamePossessive(), weekDayName(), and KCalendarSystem::year(). Referenced by formatDateTime(). |
|
Use this to determine whether in dates a possessive form of month name is preferred ("of January" rather than "January").
Definition at line 1004 of file klocale.cpp. |
|
Returns a string formatted to the current locale's conventions regarding times.
Definition at line 1724 of file klocale.cpp. References QString::at(), QTime::hour(), QString::length(), QTime::minute(), QTime::second(), QString::stripWhiteSpace(), timeFormat(), and translate(). Referenced by formatDateTime(), and formatTime(). |
|
Returns a string formatted to the current locale's conventions regarding times.
Definition at line 1719 of file klocale.cpp. References formatTime(). |
|
Use this to determine if the user wants a 12 hour clock.
Definition at line 1810 of file klocale.cpp. References QString::fromLatin1(), and timeFormat(). |
|
Use this to determine if the user wants the week to start on Monday.
Definition at line 1016 of file klocale.cpp. |
|
Use this to determine which day is the first day of the week.
Definition at line 1010 of file klocale.cpp. |
|
#include <kcalendarsystem.h>
Definition at line 548 of file klocale.cpp. References translate(). Referenced by formatDate(). |
|
#include <kcalendarsystem.h>
Definition at line 586 of file klocale.cpp. References translate(). Referenced by formatDate(). |
|
Definition at line 624 of file klocale.cpp. References calendar(), and KCalendarSystem::weekDayName(). Referenced by formatDate(). |
|
Returns a pointer to the calendar system object.
Definition at line 2257 of file klocale.cpp. References KCalendarSystemFactory::create(). Referenced by formatDate(), readDate(), and weekDayName(). |
|
Returns the name of the calendar system that is currently being used by the system.
Definition at line 2250 of file klocale.cpp. |
|
Changes the current calendar system to the calendar specified. Currently "gregorian" and "hijri" are supported. If the calendar system specified is not found, gregorian will be used.
Definition at line 2240 of file klocale.cpp. |
|
Returns a string formated to the current locale's conventions regarding both date and time.
Definition at line 1829 of file klocale.cpp. References QString::arg(), QDateTime::date(), formatDate(), formatTime(), QDateTime::time(), and translate(). |
|
Converts a localized monetary string to a double.
Definition at line 1345 of file klocale.cpp. References currencySymbol(), QString::find(), QString::isEmpty(), QString::left(), QString::length(), QString::mid(), monetaryDecimalSymbol(), monetaryThousandsSeparator(), negativeMonetarySignPosition(), negativeSign(), QString::remove(), QString::stripWhiteSpace(), and QString::toDouble(). |
|
Converts a localized numeric string to a double.
Definition at line 1280 of file klocale.cpp. References decimalSymbol(), QString::find(), QString::left(), QString::length(), QString::mid(), negativeSign(), QString::remove(), QString::stripWhiteSpace(), thousandsSeparator(), and QString::toDouble(). |
|
Converts a localized date string to a QDate. The bool pointed by ok will be invalid if the date entered was not valid.
Definition at line 1458 of file klocale.cpp. References QDate::isValid(). Referenced by readDate(). |
|
Converts a localized date string to a QDate, using the specified format. You will usually not want to use this method. Definition at line 1472 of file klocale.cpp. References QString::at(), calendar(), QDate::currentDate(), KCalendarSystem::dayStringToInteger(), QChar::isSpace(), QString::length(), QString::lower(), QString::mid(), KCalendarSystem::monthName(), KCalendarSystem::monthNamePossessive(), KCalendarSystem::monthStringToInteger(), KCalendarSystem::setYMD(), QString::simplifyWhiteSpace(), KCalendarSystem::weekDayName(), KCalendarSystem::year(), and KCalendarSystem::yearStringToInteger(). |
|
Converts a localized date string to a QDate.
This method is stricter than readDate(str,&ok): it will either accept a date in full format or a date in short format, depending on
Definition at line 1466 of file klocale.cpp. References dateFormat(), dateFormatShort(), and readDate(). |
|
Converts a localized time string to a QTime.
This method will try to parse it with seconds, then without seconds. The bool pointed to by
Definition at line 1603 of file klocale.cpp. References QTime::isValid(). |
|
Converts a localized time string to a QTime. This method is stricter than readTime(str,&ok): it will either accept a time with seconds or a time without seconds. Use this method when the format is known by the application.
Definition at line 1611 of file klocale.cpp. References QString::at(), QChar::isSpace(), QString::length(), QString::lower(), QString::mid(), QString::remove(), QString::simplifyWhiteSpace(), timeFormat(), and translate(). |
|
Returns the language used by this object. The domain AND the library translation must be available in this language. defaultLanguage() is returned by default, if no other available.
Definition at line 538 of file klocale.cpp. Referenced by _initLanguage(), and KConfigBase::setLocale(). |
|
Returns the country code of the country where the user lives. defaultCountry() is returned by default, if no other available.
Definition at line 543 of file klocale.cpp. |
|
Returns the preferred languages as ISO 639-1 codes. This means that information about country is removed. If the internal language code might be represented by more than one 639-1 code, they will all be listed (but only once). If the selected languages are "nn, nb, pt_BR", you will get: "nn, no, nb, pt".
Definition at line 2158 of file klocale.cpp. References QString::find(), QString::fromLatin1(), KConfigBase::hasKey(), languageList(), KConfigBase::readListEntry(), KConfigBase::setGroup(), and QString::truncate(). |
|
Returns the languages selected by user. The codes returned here is the internal language codes.
Definition at line 1824 of file klocale.cpp. Referenced by langLookup(), languagesTwoAlpha(), and setLanguage(). |
|
Returns the user's preferred encoding.
Definition at line 2127 of file klocale.cpp. References codecForEncoding(), and QTextCodec::name(). |
|
Returns the user's preferred encoding.
Definition at line 2132 of file klocale.cpp. References codecForEncoding(), and QTextCodec::mibEnum(). |
|
Returns the user's preferred encoding. Should never be NULL.
Definition at line 2144 of file klocale.cpp. Referenced by KCharsets::codecForName(), encoding(), encodingMib(), fileEncodingMib(), and initInstance(). |
|
Returns the file encoding.
Definition at line 2137 of file klocale.cpp. References codecForEncoding(), and QTextCodec::mibEnum(). |
|
Changes the current date format. The format of the date is a string which contains variables that will be replaced:
Definition at line 1958 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes the current short date format. The format of the date is a string which contains variables that will be replaced:
Definition at line 1964 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes the form of month name used in dates.
Definition at line 1970 of file klocale.cpp. |
|
Changes the current time format. The format of the time is string a which contains variables that will be replaced:
Definition at line 1976 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes how KLocale defines the first day in week.
Definition at line 1982 of file klocale.cpp. |
|
Changes how KLocale defines the first day in week.
Definition at line 1991 of file klocale.cpp. |
|
Returns the currently selected date format.
Definition at line 2000 of file klocale.cpp. Referenced by formatDate(), and readDate(). |
|
Returns the currently selected short date format.
Definition at line 2006 of file klocale.cpp. Referenced by formatDate(), and readDate(). |
|
Returns the currently selected time format.
Definition at line 2012 of file klocale.cpp. Referenced by formatTime(), readTime(), and use12Clock(). |
|
Changes the symbol used to identify the decimal pointer.
Definition at line 2018 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes the separator used to group digits when formating numbers.
Definition at line 2024 of file klocale.cpp. |
|
Changes the sign used to identify a positive number. Normally this is left blank.
Definition at line 2031 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes the sign used to identify a negative number.
Definition at line 2037 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes the sign position used for positive monetary values.
Definition at line 2043 of file klocale.cpp. |
|
Changes the sign position used for negative monetary values.
Definition at line 2049 of file klocale.cpp. |
|
Changes the position where the currency symbol should be printed for positive monetary values.
Definition at line 2055 of file klocale.cpp. |
|
Changes the position where the currency symbol should be printed for negative monetary values.
Definition at line 2061 of file klocale.cpp. |
|
Changes the number of digits used when formating numbers.
Definition at line 2067 of file klocale.cpp. |
|
Changes the separator used to group digits when formating monetary values.
Definition at line 2073 of file klocale.cpp. |
|
Changes the symbol used to identify the decimal pointer for monetary values.
Definition at line 2080 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Changes the current currency symbol.
Definition at line 2086 of file klocale.cpp. References QString::stripWhiteSpace(). |
|
Returns the preferred page size for printing.
Definition at line 2092 of file klocale.cpp. |
|
Changes the preferred page size when printing.
Definition at line 2098 of file klocale.cpp. |
|
Returns which measuring system we use.
Definition at line 2105 of file klocale.cpp. |
|
Changes the preferred measuring system.
Definition at line 2111 of file klocale.cpp. |
|
Adds another catalog to search for translation lookup. This function is useful for extern libraries and/or code, that provide there own messages. If the catalog does not exist for the chosen language, it will be ignored and en_US will be used.
Definition at line 629 of file klocale.cpp. Referenced by KGenericFactoryBase< KTypeList< Product, ProductListTail > >::setupTranslations(). |
|
Removes a catalog for translation lookup.
Definition at line 678 of file klocale.cpp. References KGlobal::_instance. Referenced by KGenericFactoryBase< KTypeList< Product, ProductListTail > >::~KGenericFactoryBase(). |
|
Sets the active catalog for translation lookup.
Definition at line 687 of file klocale.cpp. Referenced by KGlobal::setActiveInstance(). |
|
Translates a message as a QTranslator is supposed to. The parameters are similar to i18n(), but the result value has other semantics (it can be QString::null)
Definition at line 954 of file klocale.cpp. References endl(), and kdWarning(). |
|
Returns list of all known ISO 639-1 codes.
Definition at line 2198 of file klocale.cpp. |
|
Convert a ISO 639-1 code to a human readable form.
Definition at line 2206 of file klocale.cpp. References QString::find(), QString::left(), and QString::replace(). |
|
Returns list of all known country codes.
Definition at line 2219 of file klocale.cpp. References KGlobal::dirs(), and KStandardDirs::findAllResources(). |
|
Convert a country code to a human readable form.
Definition at line 2233 of file klocale.cpp. References QString::lower(), KConfigBase::readEntry(), and KConfigBase::setGroup(). |
|
Returns the parts of the parameter str understood as language setting the format is language_COUNTRY.charset.
Definition at line 505 of file klocale.cpp. References QString::find(), QString::mid(), and QString::truncate(). |
|
Use this as main catalog for *all* KLocales, if not the appname will be used. This function is best to be the very first instruction in your program's main function as it only has an effect before the first KLocale object is created.
Definition at line 1275 of file klocale.cpp. |
|
Finds localized resource in resourceDir( rtype ) + <lang> + fname.
Definition at line 1881 of file klocale.cpp. References defaultLanguage(), KGlobal::dirs(), endl(), QFileInfo::exists(), QFileInfo::isFile(), QFileInfo::isReadable(), kdDebug(), languageList(), KGlobal::locale(), and KStandardDirs::resourceDirs(). |
|
Returns the name of the internal language.
Definition at line 2117 of file klocale.cpp. References QString::fromLatin1(). Referenced by langLookup(), setLanguage(), and KConfigBase::setLocale(). |
|
Returns the name of the default country.
Definition at line 2122 of file klocale.cpp. References QString::fromLatin1(). |
Friends And Related Function Documentation
|
I18N_NOOP marks a string to be translated without translating it. Do not use this unless you know you need it. http://developer.kde.org/documentation/other/developer-faq.html#q2.11.2 |
|
If the string is too ambiguous to be translated well to a non-english language, use this instead of I18N_NOOP to separate lookup string and english. Warning: you need to call i18n( comment, stringVar ) later on, not just i18n( stringVar ). Definition at line 58 of file klocale.h. References i18n(). |
|
i18n is the function that does everything you need to translate a string. You just wrap around every user visible string a i18n call to get a QString with the string in the user's preferred language. The argument must be an UTF-8 encoded string (If you only use characters that are in US-ASCII, you're on the safe side. But for e.g. german umlauts or french accents should be recoded to UTF-8) Definition at line 1838 of file klocale.cpp. References QString::fromUtf8(), i18n(), KGlobal::locale(), and translate(). |
|
If the string is too ambiguous to be translated well to a non-english language, use this form of i18n to separate lookup string and english text.
Definition at line 1846 of file klocale.cpp. References QString::fromUtf8(), i18n(), KGlobal::locale(), and translate(). |
|
If you want to handle plural forms, use this form of i18n.
Definition at line 1854 of file klocale.cpp. References QString::fromUtf8(), i18n(), KGlobal::locale(), and translate(). |
|
Qt3's uic generates i18n( "msg", "comment" ) calls which conflict with our i18n method. We use uic -tr tr2i18n to redirect to the right i18n() function Definition at line 103 of file klocale.h. References i18n(). |
The documentation for this class was generated from the following files: