Класс 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().

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

enum 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(SpecialCharacter ch)

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

QChar::QChar(QLatin1Char ch)

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

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.

Category QChar::category() const

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

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

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

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

uchar QChar::cell() const

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

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

unsigned char QChar::combiningClass() const

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

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

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

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

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

[static] UnicodeVersion QChar::currentUnicodeVersion()

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

QString QChar::decomposition() const

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

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

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

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

Decomposition QChar::decompositionTag() const

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

[static] 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, если символ не является цифрой.

Direction QChar::direction() const

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

[static] 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().

JoiningType QChar::joiningType() const

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

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

[static] 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().

Script QChar::script() const

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

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

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

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

Возвращает значение свойства шрифта Unicode для символа, заданного в формате 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

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

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

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

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

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

ushort &QChar::unicode()

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

UnicodeVersion QChar::unicodeVersion() const

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

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

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

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