Класс 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") с помощью decomposition().

В Юникоде сравнение не всегда возможно, а преобразование к верхнему/нижнему регистру — это сложная задача. Юникод, охватывающий «весь» мир, также включает в себя большинство проблем с регистром и сортировкой в мире. operator==() и аналогичные функции выполняют сравнение, основываясь исключительно на числовом значении Юникода (кодовой точке) символов, а 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-битное значение.

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

См. также Юникод, 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().

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

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

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

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

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

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

enum QChar::SpecialCharacter

перечисление 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.

QChar::QChar(wchar_t ch)

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

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

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

QChar::QChar(short code)

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

QChar::QChar(uchar cell, uchar row)

Создаёт QChar для ячейки Юникода 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(uint ucs4)

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

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

uchar QChar::cell() const

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

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

unsigned char QChar::combiningClass() const

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

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

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

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

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

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

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

QString QChar::decomposition() const

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

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

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

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

QChar::Decomposition QChar::decompositionTag() const

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

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

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

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

int QChar::digitValue() const

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

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

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

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

QChar::Direction QChar::direction() const

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

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

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

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

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

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

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

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

bool QChar::hasMirrored() const

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

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

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

[static] bool QChar::hasMirrored(uint ucs4)

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

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

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

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

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

[static] ushort QChar::highSurrogate(uint ucs4)

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

bool QChar::isDigit() const

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

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

[static] bool QChar::isDigit(uint ucs4)

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

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

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

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

bool QChar::isHighSurrogate() const

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

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

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

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

bool QChar::isLetter() const

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

[static] bool QChar::isLetter(uint ucs4)

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

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

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

bool QChar::isLetterOrNumber() const

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

[static] bool QChar::isLetterOrNumber(uint ucs4)

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

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

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

bool QChar::isLowSurrogate() const

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

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

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

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

bool QChar::isLower() const

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

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

[static] bool QChar::isLower(uint ucs4)

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

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

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

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

bool QChar::isMark() const

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

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

[static] bool QChar::isMark(uint ucs4)

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

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

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

bool QChar::isNonCharacter() const

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

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

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

[static] bool QChar::isNonCharacter(uint ucs4)

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

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

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

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

bool QChar::isNull() const

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

bool QChar::isNumber() const

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

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

[static] bool QChar::isNumber(uint ucs4)

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

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

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

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

bool QChar::isPrint() const

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

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

[static] bool QChar::isPrint(uint ucs4)

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

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

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

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

bool QChar::isPunct() const

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

[static] bool QChar::isPunct(uint ucs4)

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

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

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

bool QChar::isSpace() const

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

[static] bool QChar::isSpace(uint ucs4)

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

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

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

bool QChar::isSurrogate() const

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

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

[static] bool QChar::isSurrogate(uint ucs4)

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

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

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

bool QChar::isSymbol() const

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

[static] bool QChar::isSymbol(uint ucs4)

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

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

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

bool QChar::isTitleCase() const

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

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

[static] bool QChar::isTitleCase(uint ucs4)

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

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

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

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

bool QChar::isUpper() const

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

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

[static] bool QChar::isUpper(uint ucs4)

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

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

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

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

QChar::JoiningType QChar::joiningType() const

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

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

[static] QChar::JoiningType QChar::joiningType(uint ucs4)

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

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

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

[static] ushort QChar::lowSurrogate(uint ucs4)

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

QChar QChar::mirroredChar() const

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

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

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

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

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

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

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

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

uchar QChar::row() const

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

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

QChar::Script QChar::script() const

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

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

[static] QChar::Script QChar::script(uint ucs4)

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

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

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

[static] uint QChar::surrogateToUcs4(ushort high, ushort low)

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

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

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

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

QChar QChar::toCaseFolded() const

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

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

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

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

char QChar::toLatin1() const

Возвращает эквивалент символа Latin-1 для QChar или 0. Это полезно в основном для нелокальных приложений.

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

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

QChar QChar::toLower() const

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

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

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

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

QChar QChar::toTitleCase() const

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

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

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

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

QChar QChar::toUpper() const

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

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

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

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

ushort QChar::unicode() const

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

ushort &QChar::unicode()

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

QChar::UnicodeVersion QChar::unicodeVersion() const

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

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

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

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