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

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

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

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

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

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

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

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

QChar::UnicodeVersion QChar::unicodeVersion() const

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

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

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

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