Класс 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-битные 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(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 для символа с кодовым значением 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 для символа с кодовым значением Unicode code.

QChar::QChar()

Создаёт пустой QChar ('\0').

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

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 для рендеринга текста использует эту информацию для правильного позиционирования неразрывных диакритических знаков вокруг базового символа.

unsigned char QChar::combiningClass(uint ucs4)

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

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

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

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

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.

В Юникоде определённое количество кодов классифицируется как "не символы": они могут использоваться во внутренних целях приложений, но не могут использоваться для обмена текстом. Это последние два элемента каждого плана Юникода ([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)

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