Класс QChar

Класс QChar предоставляет 16-битный символ Unicode. Подробнее...

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

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

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

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

Статические открытые члены

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

Макросы

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

В Qt, символы Юникода — это 16-битные сущности без каких-либо пометок или структуры. Этот класс представляет собой такую сущность. Он лёгкий, поэтому может использоваться везде. Большинство компиляторов обрабатывают его как unsigned short.

QChar предоставляет полный набор функций проверки/классификации, преобразования в и из других форматов, преобразования от составленных к разложенным символам Юникода и попытки сравнения и преобразования регистров, если вы об этом попросите.

Функции классификации включают функции, аналогичные функциям в стандартном заголовке C++ <cctype> (ранее <ctype.h>), но работающие с полным диапазоном символов Юникода, а не только с диапазоном ASCII. Все они возвращают true, если символ относится к определённому типу; в противном случае возвращают false. Эти функции классификации включают isNull() (возвращает true если символ равен '\0'), isPrint() (true, если символ — любой печатаемый символ, включая пробелы), isPunct() (любой символ пунктуации), isMark() (метка Юникода), isLetter() (буква), isNumber() (любой числовой символ, а не только 0-9), isLetterOrNumber() и isDigit() (десятичные цифры). Все эти функции являются обёртками вокруг category(), которые возвращают категорию, определённую Юникодом, для каждого символа. Некоторые из них также вычисляют производные свойства (например, isSpace() возвращает true если символ относится к категории Separator_* или является исключительным кодом из категории Other_Control).

QChar также предоставляет direction(), которая указывает «естественное» направление письма для этого символа. Функция joiningType() указывает, как символ соединяется со своими соседями (это необходимо в основном для арабского или сирийского) и, наконец, hasMirrored(), которая указывает, нужно ли отображать символ зеркально, когда он печатается в «неестественном» направлении письма.

Комбинированные символы Юникода (например, ring) можно преобразовать в разложенные символы Юникода ("a" за которым следует "ring above"), используя разложение().

В Юникоде сравнение не всегда возможно, а преобразование регистра — в лучшем случае очень сложно. Юникода, охватывающая «весь» мир, также включает в себя большинство проблем с регистром и сортировкой в мире. оператор==() и его аналоги будут выполнять сравнение, основываясь исключительно на числовом значении Юникода (кодовом точке) символов, а toUpper() и toLower() будут выполнять преобразование регистра, когда у символа есть хорошо определённый эквивалент верхнего/нижнего регистра. Для сравнений, зависящих от региональных настроек, используйте QString::localeAwareCompare().

Функции преобразования включают unicode() (в скаляр), toLatin1() (в скаляр, но преобразует все символы, не являющиеся Latin-1, в 0), row() (возвращает строку Юникода), cell() (возвращает ячейку Юникода), digitValue() (возвращает целочисленное значение любого из многочисленных символов цифр) и множество конструкторов.

QChar предоставляет конструкторы и операторы приведения типов, которые упрощают преобразование в традиционные 8-битные char и обратно. Если вы определили QT_NO_CAST_FROM_ASCII и QT_NO_CAST_TO_ASCII, как описано в документации QString, вам необходимо явно вызвать fromLatin1() или использовать QLatin1Char для создания QChar из 8-битного char, а также вызвать toLatin1() для получения 8-битного значения обратно.

Начиная с Qt 6.0, большинство конструкторов QChar explicit. Это делается для предотвращения опасных ошибок при случайном смешивании целочисленных типов и строк. Вы можете отказаться от этого (и сделать эти конструкторы неявными), определив макрос QT_IMPLICIT_QCHAR_CONSTRUCTION.

Дополнительную информацию см. в "Базе данных символов Юникода".

См. также Юникод, QString и QLatin1Char.

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

enum QChar::Category

Этот перечисление сопоставляет категории символов Юникода.

В Юникоде следующие символы являются нормативными:

Следующие категории являются информативными в Юникоде:

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

enum QChar::Decomposition

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

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

enum QChar::Direction

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

Для соответствия соглашениям об именах C/C++, к кодам, используемым в Стандарте Юникода, добавляется префикс "Dir".

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

перечисление QChar::JoiningType

с 5.3

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

Для соответствия соглашениям о наименовании C/C++ к кодам, используемым в стандарте Юникода, добавлено "Joining_".

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

[since 5.1] перечисление QChar::Script

Это перечисление определяет значения свойств скрипта Юникода.

Подробную информацию о значениях свойства скрипта Юникода см. в приложении к стандарту Юникода №24.

Для соответствия соглашениям о наименовании C/C++ к кодам, используемым в стандарте Юникода, добавлено "Script_".

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

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

enum QChar::SpecialCharacter

enum QChar::UnicodeVersion

Указывает, какая версия стандарта Unicode ввела определённый символ.

См. также unicodeVersion() и currentUnicodeVersion().

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

QChar::QChar(uchar ch)

Создаёт QChar, соответствующий символу ASCII/Latin-1 ch.

Примечание: Этот конструктор недоступен, когда QT_NO_CAST_FROM_ASCII или QT_RESTRICTED_CAST_FROM_ASCII определены.

См. также QT_NO_CAST_FROM_ASCII и QT_RESTRICTED_CAST_FROM_ASCII.

QChar::QChar(char ch)

Создаёт QChar, соответствующий символу ASCII/Latin-1 ch.

Примечание: Этот конструктор недоступен, когда QT_NO_CAST_FROM_ASCII определён.

См. также QT_NO_CAST_FROM_ASCII.

[since 5.10] QChar::QChar(wchar_t ch)

Создаёт QChar, соответствующий широкому символу ch.

Примечание: Этот конструктор доступен только на Windows.

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

[since 5.10] QChar::QChar(char16_t ch)

Создаёт QChar, соответствующий UTF-16 символу ch.

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

QChar::QChar(QLatin1Char ch)

Создаёт QChar, соответствующий символу ASCII/Latin-1 ch.

QChar::QChar(QChar::SpecialCharacter ch)

Создаёт QChar для предопределённого значения символа ch.

QChar::QChar(int code)

Создаёт QChar для символа с кодом Unicode code.

QChar::QChar(uint code)

Создаёт QChar для символа с кодом Unicode code.

QChar::QChar(short code)

Создаёт QChar для символа с кодом Unicode code.

QChar::QChar(uchar cell, uchar row)

Создаёт QChar для ячейки Unicode cell в строке row.

См. также cell() и row().

QChar::QChar(ushort code)

Создаёт QChar для символа с кодом Юникода code.

QChar::QChar()

Создаёт нулевой QChar ('\0').

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

QChar::Category QChar::category() const

Возвращает категорию символа.

[static] QChar::Category QChar::category(char32_t ucs4)

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

Возвращает категорию символа, закодированного в UCS-4, указанного параметром ucs4.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

uchar QChar::cell() const

Возвращает ячейку (самый младший байт) символа Юникода.

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

unsigned char QChar::combiningClass() const

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

Движок Qt для рендеринга текста использует эту информацию для правильного позиционирования знаков без пробелов вокруг базового символа.

[static] unsigned char QChar::combiningClass(char32_t ucs4)

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

Возвращает класс объединения для символа, закодированного в UCS-4, указанного параметром ucs4, как определено в стандарте Юникод.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

[static] QChar::UnicodeVersion QChar::currentUnicodeVersion()

Возвращает последнюю поддерживаемую версию Юникода.

QString QChar::decomposition() const

Разлагает символ на составные части. Возвращает пустую строку, если разложение отсутствует.

[static] QString QChar::decomposition(char32_t ucs4)

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

Разлагает символ, закодированный в UCS-4, указанный параметром ucs4, на составные части. Возвращает пустую строку, если разложение отсутствует.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

QChar::Decomposition QChar::decompositionTag() const

Возвращает тег, определяющий состав символа. Возвращает QChar::NoDecomposition, если разложение отсутствует.

[static] QChar::Decomposition QChar::decompositionTag(char32_t ucs4)

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

Возвращает тег, определяющий состав символа, закодированного в UCS-4, указанного параметром ucs4. Возвращает QChar::NoDecomposition, если разложение отсутствует.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

int QChar::digitValue() const

Возвращает числовое значение цифры или -1, если символ не является цифрой.

[static] int QChar::digitValue(char32_t ucs4)

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

Возвращает числовое значение цифры, заданной символом, закодированным в UCS-4, ucs4, или -1, если символ не является цифрой.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

QChar::Direction QChar::direction() const

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

[static] QChar::Direction QChar::direction(char32_t ucs4)

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

Возвращает направление символа, закодированного в UCS-4, указанного параметром ucs4.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

[static] QChar QChar::fromLatin1(char c)

Преобразует символ Latin-1 c в эквивалентный QChar. Это в основном полезно для программного обеспечения без локализации.

Альтернативой является использование QLatin1Char.

См. также toLatin1() и unicode().

[static, since 6.0] QChar QChar::fromUcs2(char16_t c)

Создаёт QChar из символа UTF-16 c.

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

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

[static, since 6.0] R QChar::fromUcs4(char32_t c)

Возвращает анонимную структуру,

• содержащую массив char16_t chars[2],
• которая может быть неявно преобразована в QStringView, и
• по которой можно итерироваться с помощью цикла диапазона C++11.

Если c требует суррогатов, chars[0] содержит старший суррогат и chars[1] — младший суррогат, и QStringView имеет размер 2. В противном случае, chars[0] содержит c и chars[1] имеет значение null, а QStringView имеет размер 1.

Это позволяет легко использовать результат:

QString s;
s += QChar::fromUcs4(ch);

for (char16_t c16 : QChar::fromUcs4(ch))
    use(c16);

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

См. также fromUcs2() и requiresSurrogates().

bool QChar::hasMirrored() const

Возвращает true, если символ должен быть перевёрнут при изменении направления текста; в противном случае возвращает false.

Более быстрый эквивалент (ch.mirroredChar() != ch).

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

[static, since 5.0] bool QChar::hasMirrored(char32_t ucs4)

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

Возвращает true, если символ, закодированный в UCS-4, указанный параметром ucs4, должен быть перевёрнут при изменении направления текста; в противном случае возвращает false.

Более быстрый эквивалент (QChar::mirroredChar(ucs4) != ucs4).

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

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

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

[static] char16_t QChar::highSurrogate(char32_t ucs4)

Возвращает старшую часть суррогата UCS-4 кодового элемента. Результат неопределён, если ucs4 меньше 0x10000.

Примечание: Перед Qt 6 этот метод принимал uint аргумент и возвращал ushort.

bool QChar::isDigit() const

Возвращает true если символ является десятичной цифрой (Number_DecimalDigit); в противном случае возвращает false.

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

[static, since 5.0] bool QChar::isDigit(char32_t ucs4)

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

Возвращает true если символ, закодированный в UCS-4, указанный параметром ucs4, является десятичной цифрой (Number_DecimalDigit); в противном случае возвращает false.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

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

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

bool QChar::isHighSurrogate() const

Возвращает true если QChar является старшей частью суррогата UTF16 (например, если его кодовое значение находится в диапазоне [0xd800..0xdbff]); в противном случае возвращает false.

[static] bool QChar::isHighSurrogate(char32_t ucs4)

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

Возвращает true если символ, закодированный в UCS-4, указанный параметром ucs4, является старшей частью суррогата UTF16 (например, если его кодовое значение находится в диапазоне [0xd800..0xdbff]); в противном случае возвращает false.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

bool QChar::isLetter() const

Возвращает true если символ является буквой (категории Letter_*); в противном случае возвращает false.

[static, since 5.0] bool QChar::isLetter(char32_t ucs4)

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

Возвращает true если символ, закодированный в UCS-4, указанный параметром ucs4, является буквой (категории Letter_*); в противном случае возвращает false.

Примечание: Перед Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isLetterOrNumber() const

Возвращает true если символ является буквой или цифрой (категории Letter_* или Number_*); в противном случае возвращает false.

[static, since 5.0] bool QChar::isLetterOrNumber(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является буквой или цифрой (категории Letter_* или Number_*); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isLowSurrogate() const

Возвращает true если QChar является нижней частью суррогата UTF16 (например, если его код находится в диапазоне [0xdc00..0xdfff]); в противном случае возвращает false.

[static] bool QChar::isLowSurrogate(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является нижней частью суррогата UTF16 (например, если его код находится в диапазоне [0xdc00..0xdfff]); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

bool QChar::isLower() const

Возвращает true если символ является строчной буквой, например, category() равно Letter_Lowercase.

См. также isUpper(), toLower() и toUpper().

[static, since 5.0] bool QChar::isLower(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является строчной буквой, например, category() равно Letter_Lowercase.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

См. также isUpper(), toLower(), и toUpper().

bool QChar::isMark() const

Возвращает true если символ является диакритическим знаком (категории Mark_*); в противном случае возвращает false.

См. QChar::Category для дополнительной информации о диакритических знаках.

[static, since 5.0] bool QChar::isMark(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является диакритическим знаком (категории Mark_*); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

[since 5.0] bool QChar::isNonCharacter() const

Возвращает true если QChar является недопустимым символом; в противном случае false.

В Unicode есть определенное количество кодов, классифицируемых как «недопустимые символы»: их можно использовать для внутренних целей в приложениях, но нельзя использовать для обмена текстом. Это последние два элемента в каждом плане Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff] и т. д.), а также элементы в диапазоне [0xfdd0..0xfdef].

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

[static, since 5.0] bool QChar::isNonCharacter(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является недопустимым символом; в противном случае false.

В Unicode есть определенное количество кодов, классифицируемых как «недопустимые символы»: их можно использовать для внутренних целей в приложениях, но нельзя использовать для обмена текстом. Это последние два элемента в каждом плане Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff] и т. д.), а также элементы в диапазоне [0xfdd0..0xfdef].

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isNull() const

Возвращает true если символ является символом Unicode 0x0000 ('\0'); в противном случае возвращает false.

bool QChar::isNumber() const

Возвращает true если символ является числом (категории Number_*, а не только 0-9); в противном случае возвращает false.

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

[static, since 5.0] bool QChar::isNumber(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является числом (категории Number_*, а не только 0-9); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

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

bool QChar::isPrint() const

Возвращает true если символ является печатным символом; в противном случае возвращает false. Это любой символ, не относящийся к категории Other_*.

Обратите внимание, что это не указывает на то, доступен ли символ в данном шрифте.

[static, since 5.0] bool QChar::isPrint(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является печатным символом; в противном случае возвращает false. Это любой символ, не относящийся к категории Other_*.

Обратите внимание, что это не указывает на то, доступен ли символ в данном шрифте.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isPunct() const

Возвращает true если символ является знаком препинания (категории Punctuation_*); в противном случае возвращает false.

[static, since 5.0] bool QChar::isPunct(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является знаком препинания (категории Punctuation_*); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isSpace() const

Возвращает true если символ является разделителем (категории Separator_* или определенные кодовые точки из категории Other_Control); в противном случае возвращает false.

[static, since 5.0] bool QChar::isSpace(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является разделителем (категории Separator_* или определенные кодовые точки из категории Other_Control); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

[since 5.0] bool QChar::isSurrogate() const

Возвращает true если QChar содержит код, попадающий в диапазон суррогатов UTF-16 (например, если его код находится в диапазоне [0xd800..0xdfff]); в противном случае false.

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

[static, since 5.0] bool QChar::isSurrogate(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, содержит код, попадающий в диапазон суррогатов UTF-16 (например, если его код находится в диапазоне [0xd800..0xdfff]); в противном случае false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isSymbol() const

Возвращает true если символ является символом (категории Symbol_*); в противном случае возвращает false.

[static, since 5.0] bool QChar::isSymbol(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является символом (категории Symbol_*); в противном случае возвращает false.

Примечание: До Qt 6 этот метод принимал uint аргумент.

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

bool QChar::isTitleCase() const

Возвращает true если символ является заглавной буквой, например, category() равно Letter_Titlecase.

См. также isLower(), toUpper(), toLower() и toTitleCase().

[static, since 5.0] bool QChar::isTitleCase(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, представляет заглавную букву, например, category() возвращает Letter_Titlecase.

Примечание: До Qt 6 эта функция принимала параметр uint.

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

См. также isLower(), toUpper(), toLower() и toTitleCase().

bool QChar::isUpper() const

Возвращает true если символ является заглавной буквой, например, category() возвращает Letter_Uppercase.

См. также isLower(), toUpper() и toLower().

[static, since 5.0] bool QChar::isUpper(char32_t ucs4)

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

Возвращает true если символ UCS-4, заданный параметром ucs4, представляет заглавную букву, например, category() возвращает Letter_Uppercase.

Примечание: До Qt 6 эта функция принимала параметр uint.

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

См. также isLower(), toUpper() и toLower().

[since 5.3] QChar::JoiningType QChar::joiningType() const

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

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

[static, since 5.3] QChar::JoiningType QChar::joiningType(char32_t ucs4)

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

Возвращает информацию о типе слияния символа UCS-4, заданного параметром ucs4 (необходима для некоторых языков, таких как арабский или сирийский).

Примечание: До Qt 6 эта функция принимала параметр uint.

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

[static] char16_t QChar::lowSurrogate(char32_t ucs4)

Возвращает низкий суррогат кодового значения UCS-4. Результат не определён, если ucs4 меньше 0x10000.

Примечание: До Qt 6 эта функция принимала параметр uint и возвращала ushort.

QChar QChar::mirroredChar() const

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

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

[static] char32_t QChar::mirroredChar(char32_t ucs4)

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

Возвращает зеркальный символ, если символ UCS-4, заданный параметром ucs4, является зеркальным; в противном случае возвращает сам символ.

Примечание: До Qt 6 эта функция принимала параметр uint и возвращала uint.

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

[static] bool QChar::requiresSurrogates(char32_t ucs4)

Возвращает true если символ UCS-4, заданный параметром ucs4, может быть разделен на высокую и низкую части суррогата UTF-16 (например, если его кодовое значение больше или равно 0x10000); в противном случае возвращает false.

Примечание: До Qt 6 эта функция принимала параметр uint.

uchar QChar::row() const

Возвращает строку (старший байт) символа Unicode.

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

[since 5.1] QChar::Script QChar::script() const

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

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

[static, since 5.1] QChar::Script QChar::script(char32_t ucs4)

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

Возвращает значение свойства шрифта Unicode для символа, заданного в его кодировке UCS-4 как ucs4.

Примечание: До Qt 6 эта функция принимала параметр uint.

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

[static] char32_t QChar::surrogateToUcs4(char16_t high, char16_t low)

Преобразует пару суррогатов UTF-16 с заданными значениями high и low в его кодовое значение UCS-4.

Примечание: До Qt 6 эта функция принимала ushort аргументов и возвращала uint.

[static] char32_t QChar::surrogateToUcs4(QChar high, QChar low)

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

Преобразует пару суррогатов UTF-16 (high, low) в её кодовое значение UCS-4.

Примечание: До Qt 6 эта функция возвращала uint.

QChar QChar::toCaseFolded() const

Возвращает эквивалент символа с отложенным регистром. Для большинства символов Unicode это то же самое, что и toLower().

[static] char32_t QChar::toCaseFolded(char32_t ucs4)

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

Возвращает эквивалент символа UCS-4 с отложенным регистром, заданного параметром ucs4. Для большинства символов Unicode это то же самое, что и toLower().

Примечание: До Qt 6 эта функция принимала параметр uint и возвращала uint.

char QChar::toLatin1() const

Возвращает эквивалент символа Latin-1, соответствующего QChar, или 0. Это полезно в основном для программного обеспечения, не предназначенного для международного использования.

Примечание: Невозможно отличить символ, не являющийся Latin-1, от символа Latin-1 0 (NUL). Предпочтительнее использовать unicode(), в котором нет этой неоднозначности.

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

QChar QChar::toLower() const

Возвращает эквивалент в нижнем регистре, если символ заглавный или строчный; в противном случае возвращает сам символ.

[static] char32_t QChar::toLower(char32_t ucs4)

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

Возвращает эквивалент в нижнем регистре символа UCS-4, заданного параметром ucs4, если символ заглавный или строчный; в противном случае возвращает сам символ.

Примечание: До Qt 6 эта функция принимала параметр uint и возвращала uint.

QChar QChar::toTitleCase() const

Возвращает эквивалент в заглавном регистре, если символ строчный или заглавный; в противном случае возвращает сам символ.

[static] char32_t QChar::toTitleCase(char32_t ucs4)

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

Возвращает эквивалент в заглавном регистре символа UCS-4, заданного параметром ucs4, если символ строчный или заглавный; в противном случае возвращает сам символ.

Примечание: До Qt 6 эта функция принимала параметр uint и возвращала uint.

QChar QChar::toUpper() const

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

[static] char32_t QChar::toUpper(char32_t ucs4)

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

Возвращает эквивалент в верхнем регистре символа UCS-4, заданного параметром ucs4, если символ строчный или строчный; в противном случае возвращает сам символ.

Примечание: До Qt 6 эта функция принимала параметр uint и возвращала uint.

char16_t QChar::unicode() const

Возвращает числовое значение Unicode символа QChar.

char16_t &QChar::unicode()

Возвращает ссылку на числовое значение Unicode символа QChar.

QChar::UnicodeVersion QChar::unicodeVersion() const

Возвращает версию Unicode, в которой был введён этот символ.

[static] QChar::UnicodeVersion QChar::unicodeVersion(char32_t ucs4)

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

Возвращает версию Unicode, в которой был введён символ, заданный в его кодировке UCS-4 как ucs4.

Примечание: До Qt 6 эта функция принимала параметр uint.

QString str = getString();
if (str == 123) {
    // Oops, meant str == "123". By default does not compile,
    // *unless* this macro is defined, in which case, it's interpreted
    // as `if (str == QChar(123))`, that is, `if (str == '{')`.
    // Likely, not what we meant.
}

QChar c1 =  'x'; // OK, unless QT_NO_CAST_FROM_ASCII is defined
QChar c2 = u'x'; // always OK, recommended
QChar c3 = QLatin1Char('x'); // always OK, recommended

// from int to 1 UTF-16 code unit: must guarantee that the input is <= 0xFFFF
QChar c4 = 120;        // compile error, unless QT_IMPLICIT_QCHAR_CONSTRUCTION is defined
QChar c5(120);         // OK (direct initialization)
auto  c6 = QChar(120); // ditto

// from int/char32_t to 1/2 UTF-16 code units:
// 𝄞 'MUSICAL SYMBOL G CLEF' (U+1D11E)
auto c7 = QChar(0x1D11E);           // compiles, but undefined behavior at runtime
auto c8 = QChar::fromUcs4(0x1D11E);       // always OK
auto c9 = QChar::fromUcs4(U'\U0001D11E'); // always OK
// => use c8/c9 as QStringView objects