Класс QChar

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

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

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

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

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

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

Связанные нечленные функции

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

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

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

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

Функции классификации включают функции, аналогичные функциям в стандартном заголовочном файле C++ <cctype> (ранее <ctype.h>), но работающие с полным диапазоном символов Юникода, а не только с диапазоном ASCII. Все они возвращают true, если символ относится к определённому типу символа; в противном случае они возвращают false. Эти функции классификации включают isNull() (возвращает true если символ равен '\0'), isPrint() (true, если символ является любым видом печатаемого символа, включая пробелы), isPunct() (любой вид пунктуации), isMark() (символ Юникода Mark), 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-битные chars и обратно. Если вы определили QT_NO_CAST_FROM_ASCII и QT_NO_CAST_TO_ASCII, как описано в документации QString, вам потребуется явно вызвать fromLatin1() или использовать QLatin1Char для создания QChar из 8-битного char, а для получения 8-битового значения обратно — вызвать toLatin1().

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

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

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

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

QChar::QChar(ushort code)

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

QChar::QChar(uchar cell, uchar row)

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

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

QChar::QChar(short code)

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

QChar::QChar(uint code)

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

QChar::QChar(int code)

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

QChar::QChar(QChar::SpecialCharacter ch)

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

QChar::QChar(QLatin1Char ch)

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

QChar::QChar(char16_t ch)

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

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

QChar::QChar(wchar_t ch)

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

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

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

QChar::QChar(char ch)

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

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

См. также QT_NO_CAST_FROM_ASCII.

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::Category QChar::category() const

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

QChar::Category QChar::category(uint ucs4)

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

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

uchar QChar::cell() const

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

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

unsigned char QChar::combiningClass() const

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

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

QChar::combiningClass(uint ucs4)

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

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

[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, может быть разделен на верхнюю и нижнюю части суррогата UTF16 (например, если его кодовая точка больше или равна 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)

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

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

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

Преобразует пару суррогатов UTF-16 (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.