Класс 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() (символ Юникод), 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() (возвращает строку Unicode), cell() (возвращает ячейку Unicode), digitValue() (возвращает целое значение любого из многочисленных символов цифр) и множество конструкторов.

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

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

См. также Unicode, QString и QLatin1Char.

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

enum QChar::Category

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

Следующие символы являются нормативными в Unicode:

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

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

enum QChar::Decomposition

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

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

enum QChar::Direction

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

Для соответствия соглашениям об именовании C/C++, к кодам, используемым в Стандарте Unicode, добавляется префикс "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 есть определённое количество кодовых точек, классифицируемых как «несимволы»: они могут использоваться для внутренних целей в приложениях, но не могут использоваться для обмена текстом. Это последние две записи каждого плоскости Юникода ([0xfffe..0xffff], [0x1fffe..0x1ffff] и т. д.), а также записи в диапазоне [0xfdd0..0xfdef].

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

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

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

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

В 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.