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

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

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

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

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

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

См. также QCollator.

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

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

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

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

QChar QLocale::decimalPoint() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

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

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

QChar QLocale::exponential() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

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

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

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

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

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

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

Эта функция была добавлена в 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

Возвращает язык и страну данного региона в виде строки вида "язык_страна", где язык — двузначный код языка 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

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

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

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

QLocale::NumberOptions QLocale::numberOptions() const

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

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

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

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

QChar QLocale::percent() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

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

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

QString QLocale::pmText() const

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

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

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

QChar QLocale::positiveSign() const

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

Примечание: Эта функция в Qt6 будет возвращать QString, а не QChar. Для подготовки к этому рекомендуется использовать конструктор QString(QChar).

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

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

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

QString QLocale::scriptToString(QLocale::Script script)

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

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

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

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

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

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

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

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

Эта функция была представлена в Qt 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.

Эта функция была представлена в 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().

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

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

Эта функция была представлена в Qt 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

Возвращает двойное значение, представленное локализованной строкой 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, если преобразование завершается неудачно по любой другой причине (например, недолив).

В отличие от 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

Возвращает целое число 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().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Это перегруженный метод.

Этот метод был добавлен в Qt 5.14.

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

Это перегруженный метод.

Этот метод был добавлен в Qt 5.14.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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