Класс 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's данные основаны на Common Locale Data Repository v29.

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

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

enum QLocale::Country

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

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

enum QLocale::CurrencySymbolFormat

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

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

enum QLocale::FloatingPointPrecisionOption

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

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

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

enum QLocale::FormatType

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

enum QLocale::Language

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

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

enum QLocale::MeasurementSystem

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

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

enum QLocale::NumberOptionflags QLocale::NumberOptions

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

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

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

enum QLocale::QuotationStyle

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

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

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

enum QLocale::Script

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

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

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

QLocale::QLocale()

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

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

QLocale::QLocale(const QString &name)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Country QLocale::country() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QChar QLocale::decimalPoint() const

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

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

QChar QLocale::exponential() const

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

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

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

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

QChar QLocale::groupSeparator() const

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

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

Language QLocale::language() const

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

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

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

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

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

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

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

Получение списка всех локалей: 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.

MeasurementSystem QLocale::measurementSystem() const

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

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

QString QLocale::monthName(int month, 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

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

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

NumberOptions QLocale::numberOptions() const

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

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

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

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

QChar QLocale::percent() const

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

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

QString QLocale::pmText() const

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

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

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

QChar QLocale::positiveSign() const

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

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

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

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

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

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

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

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

Script QLocale::script() const

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

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

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

QString QLocale::scriptToString(Script script)

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

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

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

void QLocale::setDefault(const QLocale &locale)

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

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

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

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

void QLocale::setNumberOptions(NumberOptions options)

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

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

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

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

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

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

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

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

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

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

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

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

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

void QLocale::swap(QLocale &other)

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

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

QLocale QLocale::system()

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

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

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

Qt::LayoutDirection QLocale::textDirection() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

bool ok;
double d;

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

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

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

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

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

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

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

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

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

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

bool ok;
double d;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Данная функция была представлена в Qt 4.8.

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

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

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

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

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

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

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

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

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

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

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

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

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

QString QLocale::toString(qlonglong i) const

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

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

QString QLocale::toString(qulonglong i) const

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

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

QString QLocale::toString(short i) const

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

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

QString QLocale::toString(ushort i) const

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

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

QString QLocale::toString(int i) const

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

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

QString QLocale::toString(uint i) const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Данная функция была представлена в Qt 4.4.

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

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

Данная функция была представлена в Qt 4.4.

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

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

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

Данная функция была представлена в Qt 4.4.

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

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

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

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

Данная функция была представлена в Qt 4.4.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QStringList QLocale::uiLanguages() const

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

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

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

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

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

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

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

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

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

QChar QLocale::zeroDigit() const

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

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

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

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

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

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

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

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

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

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