Класс QLocale

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

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

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

• setDefault(const QLocale &locale)

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

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

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

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

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

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 v35.1.

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

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

enum QLocale::Country

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

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

enum QLocale::CurrencySymbolFormat

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

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

enum QLocale::DataSizeFormatflags QLocale::DataSizeFormats

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

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

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

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

enum QLocale::FloatingPointPrecisionOption

Это перечисление определяет константы, которые могут быть переданы в качестве точности функции QString::number(), QByteArray::number() и QLocale::toString() при преобразовании чисел с плавающей точкой или двойной точности, для выражения переменного количества цифр в качестве точности.

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

См. также toString(), QString и QByteArray.

enum QLocale::FormatType

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

См. также QDateTime::toString(), QDate::toString() и QTime::toString().

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

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

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

QLocale::QLocale(const QLocale &other)

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

QLocale::QLocale(QLocale::Language language, QLocale::Script script, QLocale::Country country)

Создаёт объект QLocale с указанным language, script и country.

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

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

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

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

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

Создаёт объект QLocale с указанным language и country.

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

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

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

QLocale::QLocale(const QString &name)

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

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

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

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

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

Этот конструктор намного медленнее, чем QLocale(Country, Script, Language).

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

QLocale::QLocale()

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

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

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

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

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».

Эта локаль основана на en_US, но с различными особенностями, такими как упрощённый формат чисел и собственный формат даты. Она реализует стандарты POSIX, которые описывают поведение стандартных функций библиотеки языка программирования «C».

Это означает, что порядок сортировки основан на ASCII-значениях букв, так что (при сортировке, учитывающей регистр) все заглавные буквы сортируются перед строчными (вместо того, чтобы каждая буква и её заглавная форма сортировались рядом друг с другом, прежде чем следующая буква).

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

QLocale::Country QLocale::country() const

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

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

[static] QString QLocale::countryToString(QLocale::Country country)

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

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

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

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

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

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

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

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

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

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

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

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

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

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

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

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

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

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

QString QLocale::dayName(int day, QLocale::FormatType 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::DayOfWeek QLocale::firstDayOfWeek() const

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

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

QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

Преобразует размер в байтах в удобочитаемую локализованную строку, содержащую число и единицу измерения. Квантификатор выбирается таким образом, чтобы число было не меньше единицы и как можно меньше. Например, если bytes равно 16384, precision равно 2, а format равно DataSizeIecFormat (значение по умолчанию), функция возвращает "16.00 KiB"; для 1330409069609 байт она возвращает "1.21 GiB" и так далее. Если format равно DataSizeIecFormat или DataSizeTraditionalFormat, заданное число байт делится на степень 1024, с результатом меньше 1024; для DataSizeSIFormat — на степень 1000, с результатом меньше 1000. DataSizeIecFormat использует новые стандартизированные обозначения IEC (Ki, Mi и т. д.), а DataSizeSIFormat — устаревшие обозначения SI (k, M и т. д.), и DataSizeTraditionalFormat их неправильно использует.

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

QChar QLocale::groupSeparator() const

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

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

QLocale::Language QLocale::language() const

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

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

[static] QString QLocale::languageToString(QLocale::Language language)

Возвращает QString с именем языка language.

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

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Country country)

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

Получение списка всех локалей: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyCountry);

Получение списка локалей для России: QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia);

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

QLocale::MeasurementSystem QLocale::measurementSystem() const

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

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

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

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

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

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

QString QLocale::name() const

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

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

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

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.

QLocale::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, QLocale::QuotationStyle style = StandardQuotation) const

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

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

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

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

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

QLocale::Script QLocale::script() const

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

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

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

[static] QString QLocale::scriptToString(QLocale::Script script)

Возвращает QString с именем начертания script.

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

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

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

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

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

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

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

void QLocale::setNumberOptions(QLocale::NumberOptions options)

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

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

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

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

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

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

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

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

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

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

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

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

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

void QLocale::swap(QLocale &other)

Меняет местами локаль other с текущей локалью. Эта операция очень быстрая и никогда не завершается с ошибкой.

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

[static] QLocale QLocale::system()

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

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

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

Qt::LayoutDirection QLocale::textDirection() const

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

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

QString QLocale::timeFormat(QLocale::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(double value, const QString &symbol, int precision) const

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

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

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

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

QDate QLocale::toDate(const QString &string, QLocale::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, QLocale::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 = nullptr) const

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

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по любой другой причине (например, из-за недополнения).

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

Эта функция не обращается к локали '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 = nullptr) const

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

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по любой другой причине (например, из-за недополнения).

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

Эта функция не обращается к локали '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().

double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

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

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по любой другой причине (например, из-за недополнения).

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

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

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &ok);  // ok == true, d == 1234.56
d = c.toDouble(u"1,234.56", &ok); // ok == true, d == 1234.56
d = c.toDouble(u"1234,56", &ok);  // ok == false

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &ok);  // ok == true, d == 1234.56
d = german.toDouble(u"1.234,56", &ok); // ok == true, d == 1234.56
d = german.toDouble(u"1234.56", &ok);  // ok == false

d = german.toDouble(u"1.234", &ok);    // ok == true, d == 1234.0

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

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

Функция была добавлена в Qt 5.10.

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

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

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

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по любой другой причине (например, из-за недополнения).

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

Эта функция не обращается к локали 'C', если строку нельзя интерпретировать в текущей локали.

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

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

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

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

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по любой другой причине (например, из-за недополнения).

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

Эта функция не обращается к локали 'C', если строку нельзя интерпретировать в текущей локали.

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

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

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

float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

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

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по любой другой причине (например, из-за недополнения).

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

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

Функция была добавлена в Qt 5.10.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

int QLocale::toInt(QStringView s, bool *ok = nullptr) const

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

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

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

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

Функция была добавлена в Qt 5.10.

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

long QLocale::toLong(const QString &s, bool *ok = nullptr) const

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

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

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

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

Функция была добавлена в Qt 5.13.

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

long QLocale::toLong(const QStringRef &s, bool *ok = nullptr) const

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

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

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

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

Функция была добавлена в Qt 5.13.

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

long QLocale::toLong(QStringView s, bool *ok = nullptr) const

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

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

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

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

Функция была добавлена в Qt 5.13.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

См. также 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 = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

short QLocale::toShort(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

QString QLocale::toString(qlonglong i) const

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

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

QString QLocale::toString(qulonglong i) const

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

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

QString QLocale::toString(long i) const

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

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

QString QLocale::toString(ulong i) const

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

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

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 = ..., int prec = ...) const

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

f и prec имеют тот же смысл, что и в QString::number(double, char, int).

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

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

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

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

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

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

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

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

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

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

См. также QDateTime::toString(), QDate::toString() и QTime::toString().

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

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

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

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

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

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

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

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

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

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

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

См. также QDateTime::toString(), QDate::toString() и QTime::toString().

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

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

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

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

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

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

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

QTime QLocale::toTime(const QString &string, QLocale::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 = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

uint QLocale::toUInt(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

ulong QLocale::toULong(const QString &s, bool *ok = nullptr) const

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

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

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

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

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

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

ulong QLocale::toULong(const QStringRef &s, bool *ok = nullptr) const

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

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

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

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

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

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

ulong QLocale::toULong(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

qulonglong QLocale::toULongLong(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ushort QLocale::toUShort(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

См. также 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.

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

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