Класс 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 v31.0.1.

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

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

перечисление 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() при преобразовании чисел с плавающей точкой или double, чтобы выразить переменное количество цифр как точность.

Этот перечисление был введён или изменён в 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()

Создаёт объект 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(QLocale::Language language, QLocale::Country country = AnyCountry)

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

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

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

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

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

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

• Если язык/скрипт/страна найдены в базе данных, они используются.
• Если скрипт равен AnyScript и страна равна AnyCountry, используется язык с наиболее подходящим доступным скриптом и страной (например, Германия для немецкого языка),
• Если скрипт равен AnyScript или страна равна AnyCountry, используется первый язык, который соответствует заданному скрипту и стране.
• Если ни язык, ни страна не найдены, 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 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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает локализованное имя дня day (где 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)

Преобразует размер в байтах в удобочитаемую локальную строку, состоящую из числа и количественной единицы. Квантификатор выбирается таким образом, чтобы число было не меньше одного и как можно меньше. Например, если bytes составляет 16384, precision равен 2, а format равен DataSizeIecFormat (значение по умолчанию), эта функция возвращает "16.00 KiБ"; для 1330409069609 байт она возвращает "1,21 GiБ"; и так далее. Если 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)

Возвращает список допустимых объектов локали, соответствующих заданному language, script и 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

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

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

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

QString QLocale::name() const

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

Обратите внимание, что даже если объект QLocale был создан с явным скриптом, name() не будет его содержать по соображениям совместимости. Используйте 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)

Устанавливает параметры, связанные с преобразованиями чисел для этого экземпляра 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 и Mac эта локаль будет использовать десятичные/разделительные символы и форматы даты/времени, указанные в панели настроек системы.

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

Возвращает 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, потому что '.' является разделителем тысяч в немецкой локали.

Функция игнорирует ведущие и хвостовые пробелы.

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

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

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

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

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в 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 int, представленное локализованной строкой s.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также 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 = ..., 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 согласно указанному формату.

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

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

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

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

Этот метод был введён в 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().

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

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

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

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

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

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

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

Возвращает целое число без знака типа unsigned 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

Возвращает целое число без знака типа unsigned 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в 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.

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

Оператор присваивания перемещения.

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

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

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

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