Класс 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 является нижней частью суррогата UTF-16 (например, если его код находится в диапазоне [0xdc00..0xdfff]); в противном случае возвращает false.

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

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

Возвращает true если символ UCS-4, заданный параметром ucs4, является нижней частью суррогата UTF-16 (например, если его код находится в диапазоне [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, может быть разделен на высокую и низкую части суррогата UTF16 (например, если его код больше или равен 0x10000); в противном случае возвращает false.

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

uchar QChar::row() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QChar QChar::toCaseFolded() const

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

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

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

Возвращает эквивалент символа в сложенном формате, учитывая регистр, для символа UCS-4, указанного параметром ucs4. Для большинства символов Юникода это то же самое, что и 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

Возвращает числовое значение Юникода QChar.

char16_t &QChar::unicode()

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

QChar::UnicodeVersion QChar::unicodeVersion() const

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

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

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

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