Класс 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 == 0
d = QString("1234.56").toDouble(&ok);   // ok == true,  d == 1234.56

QLocale::setDefault(QLocale::German);
d = QString("1234,56").toDouble(&ok);   // ok == false, d == 0
d = QString("1234.56").toDouble(&ok);   // ok == true,  d == 1234.56

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
QString 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 v38.

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

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

перечисление QLocale::Country

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

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

enum QLocale::CurrencySymbolFormat

Определяет формат знака валюты.

[since 5.10] enum QLocale::DataSizeFormatфлаги QLocale::DataSizeFormats

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

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

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

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

[since 5.7] enum QLocale::FloatingPointPrecisionOption

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

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

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

enum QLocale::FormatType

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

Примечание: NarrowFormat может содержать один и тот же текст для разных месяцев и дней. Он даже может быть пустой строкой, если в локале не поддерживаются узкие имена, поэтому следует избегать его использования для форматирования дат. Кроме того, для системной локали этот формат такой же, как ShortFormat.

См. также dateFormat(), timeFormat(), dateTimeFormat(), monthName(), standaloneMonthName(), dayName(), standaloneDayName(), toDate(), toTime(), и toDateTime().

enum QLocale::Language

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

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

enum QLocale::MeasurementSystem

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

enum QLocale::NumberOptionflags QLocale::NumberOptions

Этот перечисление определяет набор параметров для преобразования чисел в строки и строк в числа. Они могут быть получены с помощью numberOptions() и установлены с помощью setNumberOptions().

Тип NumberOptions является псевдонимом для QFlags<NumberOption>. Он хранит результат побитового ИЛИ для значений NumberOption.

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

enum QLocale::QuotationStyle

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

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

enum QLocale::Script

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

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

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

QLocale::QLocale(const QLocale &other)

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

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

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

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

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

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

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

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

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

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

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

QLocale::QLocale(const QString &name)

Создаёт объект QLocale с указанным именем, имеющим формат "language[_script][_country][.codeset][@modifier]" или "C", где:

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

Разделитель может быть либо подчёркиванием '_' (U+005F), либо дефисом '-' (U+002D).

Если строка нарушает формат локали или язык не является допустимым кодом 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-часового формата.

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

QString QLocale::bcp47Name() const

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

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

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

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

QLocale QLocale::c()

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

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

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

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

QLocale QLocale::collation() const

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

Результат обычно равен этой локали; однако, системная локаль (которая обычно является локалью по умолчанию) вернёт системную локаль сортировки. Результат подходит для передачи в конструктор QCollator.

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

См. также QCollator.

QLocale::Country QLocale::country() const

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

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

QString QLocale::countryToString(QLocale::Country country)

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

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

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

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

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

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

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

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

Если формат равен LongFormat, формат будет подробным, в противном случае — кратким. Например, LongFormat для локали en_US равен dddd, MMMM d, yyyy, а ShortFormat — M/d/yy.

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

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

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

Если формат равен LongFormat, формат будет подробным, в противном случае — кратким. Например, LongFormat для локали en_US равен dddd, MMMM d, yyyy h:mm:ss AP t, а ShortFormat — M/d/yy h:mm AP.

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

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

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

Например, если локаль — en_US, и day — 1, LongFormat вернёт Monday, ShortFormat — Mon, а NarrowFormat — M.

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

QString QLocale::decimalPoint() const

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

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

QString QLocale::exponential() const

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

См. также toString(double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

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

Преобразует размер в байтах в удобочитаемую локализованную строку, состоящую из числа и единицы измерения. Квантификатор выбирается таким образом, чтобы число было не меньше единицы и как можно меньше. Например, если 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.

QString QLocale::groupSeparator() const

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

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

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);

QLocale::MeasurementSystem QLocale::measurementSystem() const

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

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

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

Например, если локаль — en_US, и month — 1, LongFormat вернёт January. ShortFormat — Jan, а NarrowFormat — J.

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

QString QLocale::name() const

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

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

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

QString QLocale::nativeCountryName() const

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

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

QString QLocale::nativeLanguageName() const

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

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

QString QLocale::negativeSign() const

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

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

QLocale::NumberOptions QLocale::numberOptions() const

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

По умолчанию для стандартных локалей параметры не заданы, за исключением локали «C», для которой по умолчанию установлен OmitGroupSeparator.

См. также setNumberOptions(), toString() и groupSeparator().

QString QLocale::percent() const

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

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

QString QLocale::pmText() const

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

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

QString QLocale::positiveSign() const

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

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

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

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

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

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

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

QLocale::Script QLocale::script() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.6] void QLocale::swap(QLocale &other)

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

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

[static] QLocale QLocale::system()

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

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

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

Qt::LayoutDirection QLocale::textDirection() const

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

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

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

Если format равен LongFormat, формат будет подробным, в противном случае — коротким. Например, LongFormat для локали en_US — h:mm:ss AP t, ShortFormat — h:mm AP.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.7] QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

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

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

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

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

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

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

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

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

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

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

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

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

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

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

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

[since 5.14] QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal) const

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

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

[since 5.14] QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal) const

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

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

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

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

Если строку невозможно распарсить, возвращает недействительную QDateTime.

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

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

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

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

Если строку невозможно распарсить, возвращает недействительную QDateTime. Если строка может быть распарсена и представляет недействительную дату/время (например, в промежутке, пропущенном при переходе часового пояса), возвращается недействительная QDateTime, чьё toMSecsSinceEpoch() представляет близкое, действительное значение. Передача этого значения в fromMSecsSinceEpoch() вернёт действительное значение даты/времени, которое не соответствует точно парсированной строке.

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

[since 5.14] QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal) const

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

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

[since 5.14] QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal) const

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

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

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, d == 0

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 == 0

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

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

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

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

[since 5.10] double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

Возвращает double, представленный локализованной строкой 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, d == 0

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 == 0

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, а успех — установив *ok в true.

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

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

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

[since 5.10] float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

Возвращает float, представленный локализованной строкой 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

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

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

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

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

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

[since 5.10] int QLocale::toInt(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.13] long QLocale::toLong(QStringView s, bool *ok = nullptr) const

Возвращает long int, представленный локализованной строкой 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 int, представленный локализованной строкой s.

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

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

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

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

[since 5.10] qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

Возвращает long long int, представленный локализованной строкой 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() в качестве универсального варианта.

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

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

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

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

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

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

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

[since 5.10] 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(), numberOptions(), zeroDigit() и positiveSign().

QString QLocale::toString(qulonglong i) const

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

См. также toULongLong(), numberOptions(), zeroDigit() и positiveSign().

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(), numberOptions(), exponential(), decimalPoint(), zeroDigit(), positiveSign() и percent().

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.10] QString QLocale::toString(QDate date, QStringView format) const

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

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

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

[since 5.10] QString QLocale::toString(QTime time, QStringView format) const

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

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

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

[since 5.10] QString QLocale::toString(const QDateTime &dateTime, QStringView format) const

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

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

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

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

Возвращает локализационную строку, представляющую заданную дату date в соответствии с указанным форматом (см. dateFormat()).

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

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

Возвращает локализационную строку, представляющую заданное время time в указанном формате (см. timeFormat()).

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

Возвращает локализационную строку, представляющую заданную дату и время dateTime в соответствии с указанным форматом (см. dateTimeFormat()).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.10] uint QLocale::toUInt(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.13] ulong QLocale::toULong(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.10] qulonglong QLocale::toULongLong(QStringView s, bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.10] 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() в качестве универсального резервного варианта.

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

QStringList QLocale::uiLanguages() const

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

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

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

Первый элемент в списке является наиболее предпочтительным.

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

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

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

QString QLocale::zeroDigit() const

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

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