Класс 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-битные char и из них. Если вы определили QT_NO_CAST_FROM_ASCII и QT_NO_CAST_TO_ASCII, как объяснено в документации QString, вам необходимо явно вызвать fromLatin1() или использовать QLatin1Char, чтобы создать QChar из 8-битного char, и вам нужно вызвать toLatin1(), чтобы получить обратно 8-битное значение.

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

См. также Unicode, 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 для символа с кодом Юникода code.

QChar::QChar()

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

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

QChar::Category QChar::category() const

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

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

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

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

uchar QChar::cell() const

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

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

unsigned char QChar::combiningClass() const

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

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

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

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

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

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

Этот метод был добавлен в 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

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

См. также 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, или 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.