Класс QLocale

Класс QLocale преобразует числа и их строковые представления на разных языках. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются повторно-входными за исключением следующих:

• setDefault(const QLocale &locale)

Открытые типы

Открытые функции

Статические публичные члены

Связанные нечлены

Подробное описание

Класс QLocale преобразует числа в их строковые представления на различных языках.

QLocale инициализируется парой язык/страна в конструкторе и предоставляет функции преобразования чисел в строки и строк в числа, аналогичные функциям в 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 i = egyptian.toInt(s2);

QLocale поддерживает понятие системного языка по умолчанию, который определяется настройками системного языка во время запуска приложения. Системный язык по умолчанию может быть изменён с помощью статического члена setDefault(). Установка системного языка по умолчанию оказывает следующие воздействия:

• Если объект QLocale создан с конструктором по умолчанию, он будет использовать настройки системного языка по умолчанию.
• QString::toInt(), QString::toDouble() и т.д. интерпретируют строку согласно системному языку по умолчанию. Если это не удаётся, используется "C" язык по умолчанию.
• QString::arg() использует системный язык по умолчанию для форматирования числа, когда спецификатор позиции в строке формата содержит 'L', например, "%L1".

Следующий пример иллюстрирует, как использовать QLocale напрямую:

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"

Когда пара язык/страна указывается в конструкторе, может произойти одно из трёх:

• Если пара язык/страна найдена в базе данных, она используется.
• Если язык найден, но страна нет, или если страна AnyCountry, язык используется с наиболее подходящей доступной страной (например, Германия для немецкого языка).
• Если ни язык, ни страна не найдены, QLocale использует системный язык по умолчанию (см. setDefault()).

Используйте language() и country() для определения фактических значений языка и страны, используемых.

Альтернативный способ создания объекта QLocale — указание имени языка.

QLocale korean("ko");
QLocale swiss("de_CH");

Этот конструктор преобразует имя языка в пару язык/страна; он не использует базу данных системного языка.

Примечание: Для текущего языка ввода клавиатуры см. QInputMethod::locale.

Данные QLocale основаны на Common Locale Data Repository v27.

Функции преобразования double в строку и строки в double покрыты следующими лицензиями:

См. также QString::arg(), QString::toInt(), QString::toDouble(), и QInputMethod::locale().

Документация типов членов

enum QLocale::Country

Этот перечисляемый тип используется для указания страны.

См. также country() и countryToString().

enum QLocale::CurrencySymbolFormat

Указывает формат знака валюты.

Этот перечисление был введён или изменён в Qt 4.8.

enum QLocale::FormatType

Это перечисление описывает типы форматов, которые могут быть использованы при преобразовании объектов QDate и QTime в строки.

enum QLocale::Language

Это перечисление используется для указания языка.

См. также language() и languageToString().

enum QLocale::MeasurementSystem

Этот перечисление определяет, какие единицы используются для измерения.

Этот перечисление был введен или изменен в Qt 4.4.

enum QLocale::NumberOptionflags QLocale::NumberOptions

Это перечисление определяет набор опций для преобразований числа в строку и строки в число. Их можно получить с помощью numberOptions() и задать с помощью setNumberOptions().

Тип NumberOptions является псевдонимом для QFlags<NumberOption>. Он хранит комбинацию значений NumberOption, объединенных операцией ИЛИ.

См. также setNumberOptions() и numberOptions().

enum QLocale::QuotationStyle

Это перечисление определяет набор возможных стилей для кавычек, специфичных для локали.

Этот перечисление был введён или изменён в Qt 4.8.

См. также quoteString().

enum QLocale::Script

Этот перечисляемый тип используется для указания сценария.

См. также script(), scriptToString() и languageToString().

Документация по членам-функциям

QLocale::QLocale()

Создаёт объект QLocale, инициализированный с использованием локалей по умолчанию. Если локаль по умолчанию не была установлена с помощью setDefault(), эта локаль будет такой же, как и возвращаемая методом system().

См. также setDefault().

QLocale::QLocale(const QString &name)

Создаёт объект QLocale с указанным именем name, которое имеет формат "язык[_скрипт][_страна][.кодировка][@модификатор]" или "C", где:

• язык — двухбуквенный, строчный, код языка ISO 639 (также некоторые трёхбуквенные коды),
• скрипт — четырёхбуквенный, заглавный, код скрипта ISO 15924,
• страна — двухбуквенный, заглавный, код страны ISO 3166 (также "419", как определено Организацией Объединённых Наций),
• и кодировка и модификатор игнорируются.

Разделитель может быть либо нижним подчеркиванием, либо знаком минуса.

Если строка нарушает формат локали или язык не является допустимым кодом ISO 639, используется локаль "C" вместо этого. Если страна не указана или не является допустимым кодом ISO 3166, выбирается наиболее подходящая страна для указанного языка.

Коды языка, скрипта и страны преобразуются в соответствующие перечисления Language, Script и Country. После этого преобразования конструктор ведёт себя точно так же, как QLocale(Страна, Скрипт, Язык).

Этот конструктор значительно медленнее, чем QLocale(Страна, Скрипт, Язык).

См. также bcp47Name().

QLocale::QLocale(Language language, Country country = AnyCountry)

Создаёт объект QLocale с указанным языком и страной.

• Если пара язык/страна найдена в базе данных, она используется.
• Если язык найден, но страна нет, или если страна — AnyCountry, язык используется с наиболее подходящей доступной страной (например, Германия для немецкого языка),
• Если ни язык, ни страна не найдены, QLocale по умолчанию использует локаль по умолчанию (см. setDefault()).

Используемые язык и страна могут быть запрошены с помощью language() и country().

См. также setDefault(), language() и country().

QLocale::QLocale(Язык language, Написание script, Страна country)

Создаёт объект QLocale с указанным языком, написанием и страной.

• Если язык/написание/страна найдены в базе данных, они используются.
• Если написание равно любоеНаписание и страна равно любаяСтрана, язык используется с наиболее подходящим доступным написанием и страной (например, Германия для немецкого языка).
• Если написание равно любоеНаписание или страна равно любаяСтрана, язык используется с первой локалью, которая соответствует заданному написанию и стране.
• Если ни язык, ни страна не найдены, QLocale по умолчанию использует локаль по умолчанию (см. setDefault()).

Используемый язык, написание и страна могут быть запрошены с помощью language(), script() и country().

Данная функция была добавлена в Qt 4.8.

См. также setDefault(), language(), script(), и country().

QLocale::QLocale(const QLocale &other)

Создаёт объект QLocale как копию other.

QLocale::~QLocale()

Деструктор

QString QLocale::amText() const

Возвращает локализованное имя суффикса "AM" для времени, указанного с использованием 12-часового формата.

Данная функция была добавлена в Qt 4.5.

См. также pmText().

QString QLocale::bcp47Name() const

Возвращает строку с языком, написанием и страной (и, возможно, другими полями BCP47) этой локали, разделёнными дефисами.

В отличие от uiLanguages(), возвращаемое значение bcp47Name() представляет имя локали данных QLocale, а не язык, на котором должен быть интерфейс пользователя.

Данная функция пытается привести имя локали в соответствие с BCP47.

Данная функция была добавлена в Qt 4.8.

См. также language(), country(), script(), и uiLanguages().

[static] QLocale QLocale::c()

Возвращает объект QLocale, инициализированный локалью "C".

См. также system().

Страна QLocale::country() const

Возвращает страну этой локали.

См. также язык(), написание(), countryToString() и bcp47Name().

[static] QString QLocale::countryToString(Страна country)

Возвращает QString, содержащий имя country.

См. также languageToString(), scriptToString(), country() и bcp47Name().

QString QLocale::createSeparatedList(const QStringList &list) const

Возвращает строку, представляющую собой объединение заданного списка строк list с разделителем, определённым локалью.

Данная функция была добавлена в Qt 4.8.

QString QLocale::currencySymbol(ФорматСимволаВалюты format = CurrencySymbol) const

Возвращает символ валюты в соответствии с format.

Данная функция была добавлена в Qt 4.8.

QString QLocale::dateFormat(ТипФормата format = LongFormat) const

Возвращает формат даты, используемый для текущей локали.

Если format равен LongFormat, формат будет длинным. В противном случае используется короткий формат.

Данная функция была добавлена в Qt 4.1.

См. также QDate::toString() и QDate::fromString().

QString QLocale::dateTimeFormat(ТипФормата format = LongFormat) const

Возвращает формат даты и времени, используемый для текущей локали.

Если format равен ShortFormat, формат будет коротким. В противном случае используется более длинный формат.

Данная функция была добавлена в Qt 4.4.

См. также QDateTime::toString() и QDateTime::fromString().

QString QLocale::dayName(int day, ТипФормата type = LongFormat) const

Возвращает локализованное имя дня (где 1 соответствует понедельнику, 2 — вторнику и так далее) в формате, заданном type.

Данная функция была добавлена в Qt 4.2.

См. также monthName() и standaloneDayName().

QChar QLocale::decimalPoint() const

Возвращает символ десятичной точки этой локали.

Данная функция была добавлена в Qt 4.1.

QChar QLocale::exponential() const

Возвращает символ экспоненты этой локали.

Данная функция была добавлена в Qt 4.1.

Qt::ДеньНедели QLocale::firstDayOfWeek() const

Возвращает первый день недели в соответствии с текущей локалью.

Данная функция была добавлена в Qt 4.8.

QChar QLocale::groupSeparator() const

Возвращает символ разделителя групп этой локали.

Данная функция была добавлена в Qt 4.1.

Язык QLocale::language() const

Возвращает язык этой локали.

См. также написание(), страна(), languageToString() и bcp47Name().

[static] QString QLocale::languageToString(Язык language)

Возвращает QString, содержащий имя language.

См. также countryToString(), scriptToString() и bcp47Name().

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Язык language, QLocale::Написание script, QLocale::Страна country)

Возвращает список допустимых объектов локали, которые соответствуют заданному языку, написанию и стране.

Получение списка всех локалей: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::любойЯзык, QLocale::любоеНаписание, QLocale::любаяСтрана);

Получение списка локалей, подходящих для России: QList<QLocale> locales = QLocale::matchingLocales(QLocale::любойЯзык, QLocale::любоеНаписание, QLocale::Россия);

Данная функция была добавлена в Qt 4.8.

СистемаИзмерений QLocale::measurementSystem() const

Возвращает систему измерений для локали.

Данная функция была добавлена в Qt 4.4.

QString QLocale::monthName(int month, ТипФормата type = LongFormat) const

Возвращает локализованное имя месяца в формате, заданном type.

Данная функция была добавлена в Qt 4.2.

См. также dayName() и standaloneMonthName().

QString QLocale::name() const

Возвращает язык и страну этой локали в виде строки формата "язык_страна", где язык — двухбуквенный код ISO 639 в нижнем регистре, а страна — двух- или трехбуквенный код ISO 3166 в верхнем регистре.

Обратите внимание, что даже если объект QLocale был создан с явным написанием, name() не будет содержать его по соображениям совместимости. Используйте bcp47Name() вместо этого, если вам нужно полное имя локали.

См. также QLocale(), язык(), алфавит(), страна() и имя_в_формате_bcp47().

QString QLocale::nativeCountryName() const

Возвращает собственное имя страны для текущего языка. Например, «España» для языка/страны испанский/Испания.

Эта функция была введена в Qt 4.8.

См. также nativeLanguageName() и countryToString().

QString QLocale::nativeLanguageName() const

Возвращает собственное имя языка для текущего языка. Например, «Schwiizertüütsch» для швейцарско-немецкого языка.

Эта функция была введена в Qt 4.8.

См. также nativeCountryName() и languageToString().

QChar QLocale::negativeSign() const

Возвращает символ минуса для текущего языка.

Эта функция была введена в Qt 4.1.

NumberOptions QLocale::numberOptions() const

Возвращает параметры, связанные с преобразованием чисел для этого объекта QLocale.

По умолчанию для стандартных языков параметры не установлены.

Эта функция была введена в Qt 4.2.

См. также setNumberOptions().

QChar QLocale::percent() const

Возвращает символ процента для текущего языка.

Эта функция была введена в Qt 4.1.

QString QLocale::pmText() const

Возвращает локализованное имя суффикса «PM» для времени, заданного с использованием 12-часового формата.

Эта функция была введена в Qt 4.5.

См. также amText().

QChar QLocale::positiveSign() const

Возвращает символ плюса для текущего языка.

Эта функция была введена в Qt 4.5.

QString QLocale::quoteString(const QString &str, QuotationStyle style = StandardQuotation) const

Возвращает строку str, заключённую в кавычки в соответствии с текущим языком с использованием заданного стиля кавычек style.

Эта функция была введена в Qt 4.8.

QString QLocale::quoteString(const QStringRef &str, QuotationStyle style = StandardQuotation) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

Script QLocale::script() const

Возвращает алфавит для текущего языка.

Эта функция была введена в Qt 4.8.

См. также язык(), страна(), languageToString(), scriptToString() и имя_в_формате_bcp47().

QString QLocale::scriptToString(Script script)

Возвращает строку QString содержащую имя script.

Эта функция была введена в Qt 4.8.

См. также languageToString(), countryToString(), алфавит() и имя_в_формате_bcp47().

void QLocale::setDefault(const QLocale &locale)

Устанавливает глобальный язык по умолчанию в locale. Эти значения используются, когда объект QLocale создаётся без аргументов. Если эта функция не вызывается, используется системный язык.

Предупреждение: В многопоточной программе язык по умолчанию следует установить при запуске приложения, до создания любых потоков, не являющихся графическими.

Предупреждение: Эта функция не реентерабельна.

См. также system() и c().

void QLocale::setNumberOptions(NumberOptions options)

Устанавливает параметры options, связанные с преобразованием чисел для этого объекта QLocale.

Эта функция была введена в Qt 4.2.

См. также numberOptions().

QString QLocale::standaloneDayName(int day, FormatType type = LongFormat) const

Возвращает локализованное имя day (где 1 соответствует понедельнику, 2 — вторнику и так далее), используемого как самостоятельный текст в формате, заданном type.

Если информация о языке не определяет отдельное имя дня, то возвращаемое значение совпадает с dayName().

Эта функция была введена в Qt 4.5.

См. также dayName() и standaloneMonthName().

QString QLocale::standaloneMonthName(int month, FormatType type = LongFormat) const

Возвращает локализованное имя month, используемое как самостоятельный текст в формате, заданном type.

Если информация о языке не определяет отдельное имя месяца, то возвращаемое значение совпадает с monthName().

Эта функция была введена в Qt 4.5.

См. также monthName() и standaloneDayName().

QLocale QLocale::system()

Возвращает объект QLocale, инициализированный системным языком.

В Windows и Mac этот язык будет использовать десятичные/разделительные символы и форматы дат/времени, указанные в настройках системы.

См. также c().

Qt::LayoutDirection QLocale::textDirection() const

Возвращает направление текста для языка.

Эта функция была введена в Qt 4.7.

QString QLocale::timeFormat(FormatType format = LongFormat) const

Возвращает формат времени, используемый для текущего языка.

Если format равен LongFormat, формат будет длинным. В противном случае используется более короткий вариант.

Эта функция была введена в Qt 4.1.

См. также QTime::toString() и QTime::fromString().

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

Возвращает локализованное строковое представление value в виде валюты. Если symbol указан, он используется вместо символа валюты по умолчанию.

Эта функция была введена в Qt 4.8.

См. также currencySymbol().

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

QString QLocale::toCurrencyString(double value, const QString &symbol = QString()) const

Это перегруженная функция.

Эта функция была введена в Qt 4.8.

QString QLocale::toCurrencyString(float value, const QString &symbol = QString()) const

Это перегруженный функция.

Эта функция была добавлена в Qt 4.8.

QDate QLocale::toDate(const QString &string, FormatType format = LongFormat) const

Парсит строку даты, заданную в string, и возвращает дату. Формат строки даты выбирается в соответствии с параметром format (см. dateFormat()).

Если дату нельзя было разобрать, возвращает недействительную дату.

Эта функция была добавлена в Qt 4.4.

См. также dateFormat(), toTime(), toDateTime() и QDate::fromString().

QDate QLocale::toDate(const QString &string, const QString &format) const

Парсит строку даты, заданную в string, и возвращает дату. См. QDate::fromString() для информации о выражениях, которые можно использовать с этой функцией.

Функция ищет названия месяцев и дней недели в текущем языковом окружении.

Если дату нельзя было разобрать, возвращает недействительную дату.

Эта функция была добавлена в Qt 4.4.

См. также dateFormat(), toTime(), toDateTime() и QDate::fromString().

QDateTime QLocale::toDateTime(const QString &string, FormatType format = LongFormat) const

Парсит строку даты и времени, заданную в string, и возвращает время. Формат строки даты и времени выбирается в соответствии с параметром format (см. dateTimeFormat()).

Если строку нельзя было разобрать, возвращает недействительный QDateTime.

Эта функция была добавлена в Qt 4.4.

См. также dateTimeFormat(), toTime(), toDate() и QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, const QString &format) const

Парсит строку даты и времени, заданную в string, и возвращает время. См. QDateTime::fromString() для информации о выражениях, которые можно использовать с этой функцией.

Примечание: Имена месяцев и дней недели должны быть указаны на языке пользователя.

Если строку нельзя было разобрать, возвращает недействительный QDateTime.

Эта функция была добавлена в Qt 4.4.

См. также dateTimeFormat(), toTime(), toDate() и QDateTime::fromString().

double QLocale::toDouble(const QString &s, bool *ok = Q_NULLPTR) const

Возвращает double, представленный локализованной строкой s, или 0.0, если преобразование не удалось.

Если ok не равен 0, сообщает об ошибке, установив *ok в false, и об успехе, установив *ok в true.

В отличие от QString::toDouble(), эта функция не возвращается к локали "C", если строку нельзя интерпретировать в этой локали.

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

Обратите внимание, что последнее преобразование возвращает 1234.0, потому что «.» является разделителем тысяч в немецкой локали.

Эта функция игнорирует начальные и конечные пробелы.

См. также toFloat(), toInt() и toString().

double QLocale::toDouble(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает double, представленный локализованной строкой s, или 0.0, если преобразование не удалось.

Если ok не равно null, сообщает об ошибке, установив *ok в false, и об успехе, установив *ok в true.

В отличие от QString::toDouble(), эта функция не возвращается к локали "C", если строку нельзя интерпретировать в этой локали.

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

Обратите внимание, что последнее преобразование возвращает 1234.0, потому что «.» является разделителем тысяч в немецкой локали.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.1.

См. также toFloat(), toInt() и toString().

float QLocale::toFloat(const QString &s, bool *ok = Q_NULLPTR) const

Возвращает float, представленный локализованной строкой s, или 0.0, если преобразование не удалось.

Если ok не равен 0, сообщает об ошибке, установив *ok в false, и об успехе, установив *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toDouble(), toInt() и toString().

float QLocale::toFloat(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает float, представленный локализованной строкой s, или 0.0, если преобразование не удалось.

Если ok не равно null, сообщает об ошибке, установив *ok в false, и об успехе, установив *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.1.

См. также toDouble(), toInt() и toString().

int QLocale::toInt(const QString &s, bool *ok = Q_NULLPTR) const

Возвращает int, представленный локализованной строкой s.

Если преобразование не удалось, функция возвращает 0.

Если ok не равен 0, об ошибке сообщается, установив *ok в false, об успехе — установив *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toUInt() и toString().

int QLocale::toInt(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает int, представленный локализованной строкой s.

Если преобразование не удалось, функция возвращает 0.

Если ok не равно null, об ошибке сообщается, установив *ok в false, об успехе — установив *ok в true.

Эта функция была добавлена в Qt 5.1.

См. также toUInt() и toString().

qlonglong QLocale::toLongLong(const QString &s, bool *ok = Q_NULLPTR) const

Возвращает long long int, представленный локализованной строкой s.

Если преобразование не удалось, функция возвращает 0.

Если ok не равен 0, об ошибке сообщается, установив *ok в false, об успехе — установив *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toInt(), toULongLong(), toDouble() и toString().

qlonglong QLocale::toLongLong(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает long long int, представленный локализованной строкой s.

Если преобразование не удалось, функция возвращает 0.

Если ok не равно null, об ошибке сообщается, установив *ok в false, об успехе — установив *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.1.

См. также toInt(), toULongLong(), toDouble() и toString().

QString QLocale::toLower(const QString &str) const

Возвращает копию str в нижнем регистре.

Если Qt Core использует библиотеки ICU, они будут использоваться для выполнения преобразования в соответствии с правилами текущей локали. В противном случае преобразование может быть выполнено платформозависимым образом с помощью QString::toLower() в качестве универсального резервного варианта.

Эта функция была добавлена в Qt 4.8.

См. также QString::toLower().

short QLocale::toShort(const QString &s, bool *ok = Q_NULLPTR) const

Возвращает short int, представленный локализованной строкой s.

Если преобразование не удалось, функция возвращает 0.

Если ok не равен 0, об ошибке сообщается, установив *ok в false, об успехе — установив *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toUShort() и toString().

short QLocale::toShort(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает целое число со знаком типа short, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не равен null, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была введена в Qt 5.1.

См. также toUShort() и toString().

QString QLocale::toString(qlonglong i) const

Возвращает локализованное строковое представление числа i.

См. также toLongLong().

QString QLocale::toString(qulonglong i) const

Это перегруженная функция.

См. также toULongLong().

QString QLocale::toString(short i) const

Это перегруженная функция.

См. также toShort().

QString QLocale::toString(ushort i) const

Это перегруженная функция.

См. также toUShort().

QString QLocale::toString(int i) const

Это перегруженная функция.

См. также toInt().

QString QLocale::toString(uint i) const

Это перегруженная функция.

См. также toUInt().

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

Это перегруженная функция.

f и prec имеют то же значение, что и в QString::number(double, char, int).

См. также toDouble().

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

Это перегруженная функция.

f и prec имеют то же значение, что и в QString::number(double, char, int).

См. также toDouble().

QString QLocale::toString(const QDate &date, const QString &format) const

Возвращает локализованное строковое представление указанной даты date в заданном формате format. Если format пустая строка, возвращается пустая строка.

QString QLocale::toString(const QDate &date, FormatType format = LongFormat) const

Возвращает локализованное строковое представление заданной даты date в соответствии с указанным форматом.

QString QLocale::toString(const QTime &time, const QString &format) const

Возвращает локализованное строковое представление заданного времени time в соответствии с указанным форматом. Если format пустая строка, возвращается пустая строка.

QString QLocale::toString(const QTime &time, FormatType format = LongFormat) const

Возвращает локализованное строковое представление заданного времени time в указанном формате.

QString QLocale::toString(const QDateTime &dateTime, FormatType format = LongFormat) const

Возвращает локализованное строковое представление заданной даты и времени dateTime в соответствии с указанным форматом.

Эта функция была введена в Qt 4.4.

QString QLocale::toString(const QDateTime &dateTime, const QString &format) const

Возвращает локализованное строковое представление заданной даты и времени dateTime в соответствии с указанным форматом. Если format пустая строка, возвращается пустая строка.

Эта функция была введена в Qt 4.4.

QTime QLocale::toTime(const QString &string, FormatType format = LongFormat) const

Разбирает строку времени, заданную в string, и возвращает время. Формат строки времени выбирается в соответствии с параметром format (см. timeFormat()).

Если время нельзя разобрать, возвращается недействительное время.

Эта функция была введена в Qt 4.4.

См. также timeFormat(), toDate(), toDateTime(), и QTime::fromString().

QTime QLocale::toTime(const QString &string, const QString &format) const

Разбирает строку времени, заданную в string, и возвращает время. См. QTime::fromString() для получения информации о том, что представляет собой допустимая строка формата.

Если время нельзя разобрать, возвращается недействительное время.

Эта функция была введена в Qt 4.4.

См. также timeFormat(), toDate(), toDateTime(), и QTime::fromString().

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

Возвращает целое беззнаковое число типа uint, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не равен 0, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toInt() и toString().

uint QLocale::toUInt(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает целое беззнаковое число типа uint, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не равен null, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была введена в Qt 5.1.

См. также toInt() и toString().

qulonglong QLocale::toULongLong(const QString &s, bool *ok = Q_NULLPTR) const

Возвращает целое беззнаковое число типа unsigned long long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не равен 0, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toLongLong(), toInt(), toDouble(), и toString().

qulonglong QLocale::toULongLong(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает целое беззнаковое число типа unsigned long long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не равен null, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была введена в Qt 5.1.

См. также toLongLong(), toInt(), toDouble(), и toString().

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

Возвращает целое беззнаковое число типа unsigned short, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не равен 0, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toShort() и toString().

ushort QLocale::toUShort(const QStringRef &s, bool *ok = Q_NULLPTR) const

Возвращает целое беззнаковое число типа short, представленное локализованной строкой s.

Если преобразование не удалось, функция возвращает 0.

Если ok не равен null, ошибка будет сообщена установкой *ok в false, а успех — установкой *ok в true.

Функция игнорирует начальные и конечные пробелы.

Данная функция была добавлена в Qt 5.1.

См. также toShort() и toString().

QString QLocale::toUpper(const QString &str) const

Возвращает копию строки str в верхнем регистре.

Если Qt Core использует библиотеки ICU, они будут использованы для выполнения преобразования в соответствии с правилами текущей локали. В противном случае преобразование может выполняться платформозависимым способом, с QString::toUpper() в качестве универсального варианта по умолчанию.

Данная функция была добавлена в Qt 4.8.

См. также QString::toUpper().

QStringList QLocale::uiLanguages() const

Возвращает упорядоченный список кодов локалей для целей перевода в порядке предпочтения (например, "en-Latn-US", "en-US", "en").

Возвращаемое значение представляет имена локалей, в которых пользователь ожидает увидеть перевод пользовательского интерфейса.

Вероятно, вам не нужно использовать эту функцию напрямую, а просто передать объект QLocale в функцию QTranslator::load().

Первый элемент в списке имеет наивысший приоритет.

Данная функция была добавлена в Qt 4.8.

См. также QTranslator и bcp47Name().

QList<Qt::DayOfWeek> QLocale::weekdays() const

Возвращает список дней, которые считаются рабочими днями в соответствии с текущей локалью.

Данная функция была добавлена в Qt 4.8.

QChar QLocale::zeroDigit() const

Возвращает символ цифры ноль для данной локали.

Данная функция была добавлена в Qt 4.1.

bool QLocale::operator!=(const QLocale &other) const

Возвращает true если объект QLocale не такой же, как указанная локаль other; в противном случае возвращает false.

QLocale &QLocale::operator=(const QLocale &other)

Присваивает other этому объекту QLocale и возвращает ссылку на этот объект QLocale.

bool QLocale::operator==(const QLocale &other) const

Возвращает true если объект QLocale такой же, как указанная локаль other; в противном случае возвращает false.