QChar Class
La clase QChar representa un carácter Unicode de 16 bits. Más información...
| Encabezado: | #include <QChar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QChar forma parte de las clases para datos de cadena.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QChar
| Categoría | Tipos comparables | Descripción |
|---|---|---|
| strong | QChar | |
| strong | char16_t, QString, QStringView, QLatin1StringView y QUtf8StringView. | |
| strong | const char *, QByteArray y QByteArrayView. | El contenido de la matriz de bytes se interpreta como UTF-8. |
Tipos públicos
| enum | Category { Mark_NonSpacing, Mark_SpacingCombining, Mark_Enclosing, Number_DecimalDigit, Number_Letter, …, Symbol_Other } |
| enum | Decomposition { NoDecomposition, Canonical, Circle, Compat, Final, …, Wide } |
| enum | Direction { DirAL, DirAN, DirB, DirBN, DirCS, …, DirWS } |
| enum | JoiningType { Joining_None, Joining_Causing, Joining_Dual, Joining_Right, Joining_Left, Joining_Transparent } |
| enum | Script { Script_Unknown, Script_Inherited, Script_Common, Script_Adlam, Script_Ahom, …, Script_ZanabazarSquare } |
| enum | SpecialCharacter { Null, Tabulation, LineFeed, FormFeed, CarriageReturn, …, LastValidCodePoint } |
| enum | UnicodeVersion { Unicode_1_1, Unicode_2_0, Unicode_2_1_2, Unicode_3_0, Unicode_3_1, …, Unicode_Unassigned } |
Funciones públicas
| QChar() | |
| QChar(QChar::SpecialCharacter ch) | |
| QChar(QLatin1Char ch) | |
| QChar(char ch) | |
| QChar(char16_t ch) | |
| QChar(char32_t code) | |
| QChar(int code) | |
| QChar(short code) | |
| QChar(uchar ch) | |
| QChar(uint code) | |
| QChar(ushort code) | |
| QChar(wchar_t ch) | |
| QChar(uchar cell, uchar row) | |
| QChar::Category | category() const |
| uchar | cell() const |
| unsigned char | combiningClass() const |
| QString | decomposition() const |
| QChar::Decomposition | decompositionTag() const |
| int | digitValue() const |
| QChar::Direction | direction() const |
| bool | hasMirrored() const |
| bool | isDigit() const |
| bool | isHighSurrogate() const |
| bool | isLetter() const |
| bool | isLetterOrNumber() const |
| bool | isLowSurrogate() const |
| bool | isLower() const |
| bool | isMark() const |
| bool | isNonCharacter() const |
| bool | isNull() const |
| bool | isNumber() const |
| bool | isPrint() const |
| bool | isPunct() const |
| bool | isSpace() const |
| bool | isSurrogate() const |
| bool | isSymbol() const |
| bool | isTitleCase() const |
| bool | isUpper() const |
| QChar::JoiningType | joiningType() const |
| QChar | mirroredChar() const |
| uchar | row() const |
| QChar::Script | script() const |
| QChar | toCaseFolded() const |
| char | toLatin1() const |
| QChar | toLower() const |
| QChar | toTitleCase() const |
| QChar | toUpper() const |
| char16_t & | unicode() |
| char16_t | unicode() const |
| QChar::UnicodeVersion | unicodeVersion() const |
Miembros públicos estáticos
| QChar::Category | category(char32_t ucs4) |
| unsigned char | combiningClass(char32_t ucs4) |
| QChar::UnicodeVersion | currentUnicodeVersion() |
| QString | decomposition(char32_t ucs4) |
| QChar::Decomposition | decompositionTag(char32_t ucs4) |
| int | digitValue(char32_t ucs4) |
| QChar::Direction | direction(char32_t ucs4) |
| QChar | fromLatin1(char c) |
(since 6.0) QChar | fromUcs2(char16_t c) |
(since 6.0) auto | fromUcs4(char32_t c) |
| bool | hasMirrored(char32_t ucs4) |
| char16_t | highSurrogate(char32_t ucs4) |
| bool | isDigit(char32_t ucs4) |
| bool | isHighSurrogate(char32_t ucs4) |
| bool | isLetter(char32_t ucs4) |
| bool | isLetterOrNumber(char32_t ucs4) |
| bool | isLowSurrogate(char32_t ucs4) |
| bool | isLower(char32_t ucs4) |
| bool | isMark(char32_t ucs4) |
| bool | isNonCharacter(char32_t ucs4) |
| bool | isNumber(char32_t ucs4) |
| bool | isPrint(char32_t ucs4) |
| bool | isPunct(char32_t ucs4) |
| bool | isSpace(char32_t ucs4) |
| bool | isSurrogate(char32_t ucs4) |
| bool | isSymbol(char32_t ucs4) |
| bool | isTitleCase(char32_t ucs4) |
| bool | isUpper(char32_t ucs4) |
| QChar::JoiningType | joiningType(char32_t ucs4) |
| char16_t | lowSurrogate(char32_t ucs4) |
| char32_t | mirroredChar(char32_t ucs4) |
| bool | requiresSurrogates(char32_t ucs4) |
| QChar::Script | script(char32_t ucs4) |
| char32_t | surrogateToUcs4(char16_t high, char16_t low) |
| char32_t | surrogateToUcs4(QChar high, QChar low) |
| char32_t | toCaseFolded(char32_t ucs4) |
| char32_t | toLower(char32_t ucs4) |
| char32_t | toTitleCase(char32_t ucs4) |
| char32_t | toUpper(char32_t ucs4) |
| QChar::UnicodeVersion | unicodeVersion(char32_t ucs4) |
Elementos no miembros relacionados
| bool | operator!=(const QChar &c1, const QChar &c2) |
| bool | operator<(const QChar &c1, const QChar &c2) |
| QDataStream & | operator<<(QDataStream &out, QChar chr) |
| bool | operator<=(const QChar &c1, const QChar &c2) |
| bool | operator==(const QChar &c1, const QChar &c2) |
| bool | operator>(const QChar &c1, const QChar &c2) |
| bool | operator>=(const QChar &c1, const QChar &c2) |
| QDataStream & | operator>>(QDataStream &in, QChar &chr) |
Descripción detallada
En Qt, los caracteres Unicode son entidades de 16 bits sin ningún tipo de marcado ni estructura. Esta clase representa una entidad de este tipo. Es ligera, por lo que se puede utilizar en cualquier lugar. La mayoría de los compiladores la tratan como un ` unsigned short`.
QChar proporciona un conjunto completo de funciones de comprobación y clasificación, permite la conversión hacia y desde otros formatos, la conversión de Unicode compuesto a descompuesto, y trata de realizar comparaciones y cambios de mayúsculas y minúsculas si así se le solicita.
Las funciones de clasificación incluyen funciones similares a las del encabezado estándar de C++ <cctype> (antes <ctype.h>), pero operan sobre toda la gama de caracteres Unicode, no solo sobre el rango ASCII. Todas devuelven «true» si el carácter es de un tipo determinado; en caso contrario, devuelven «false». Estas funciones de clasificación son isNull() (devuelve « true » si el carácter es «\0 »), isPrint() (verdadero si el carácter es cualquier tipo de carácter imprimible, incluidos los espacios en blanco), isPunct() (cualquier tipo de signo de puntuación), isMark() (marca Unicode), isLetter() (una letra), isNumber() (cualquier tipo de carácter numérico, no solo del 0 al 9), isLetterOrNumber() y isDigit() (dígitos decimales). Todas ellas son envoltorios de category() que devuelven la categoría definida por Unicode de cada carácter. Algunas de ellas también calculan las propiedades derivadas (por ejemplo, isSpace() devuelve true si el carácter pertenece a la categoría Separator_* o es un punto de código excepcional de la categoría Other_Control ).
QChar también proporciona direction(), que indica la dirección de escritura «natural» de este carácter. La función joiningType() indica cómo se une el carácter con sus vecinos (necesario sobre todo para el árabe o el siríaco) y, por último, hasMirrored(), que indica si el carácter debe invertirse cuando se imprime en su dirección de escritura «no natural».
Los caracteres Unicode compuestos (como ring) pueden convertirse a Unicode descompuesto («a» seguida de «anillo superior») utilizando decomposition().
En Unicode, la comparación no siempre es posible y la conversión de mayúsculas y minúsculas resulta, en el mejor de los casos, muy complicada. Unicode, que abarca «todo» el mundo, también incluye la mayoría de los problemas de mayúsculas y minúsculas y de ordenación existentes en el mundo. El operador ==() y sus variantes realizarán la comparación basándose exclusivamente en el valor numérico Unicode (punto de código) de los caracteres, mientras que toUpper() y toLower() realizarán cambios de mayúsculas y minúsculas cuando el carácter tenga un equivalente bien definido en mayúsculas o minúsculas. Para comparaciones dependientes de la configuración regional, utiliza QString::localeAwareCompare().
Las funciones de conversión incluyen unicode() (a un escalar), toLatin1() (a un escalar, pero convierte todos los caracteres que no sean Latin-1 a 0), row() (devuelve la fila Unicode), cell() (devuelve la celda Unicode), digitValue() (devuelve el valor entero de cualquiera de los numerosos caracteres numéricos) y una gran variedad de constructores.
QChar proporciona constructores y operadores de conversión que facilitan la conversión hacia y desde los caracteres tradicionales de 8 bits « char». Si has definido ` QT_NO_CAST_FROM_ASCII ` y ` QT_NO_CAST_TO_ASCII`, tal y como se explica en la documentación de ` QString `, tendrás que llamar explícitamente a ` fromLatin1()` o utilizar ` QLatin1Char` para construir un `QChar` a partir de un ` char` de 8 bits, y tendrás que llamar a ` toLatin1()` para recuperar el valor de 8 bits.
A partir de Qt 6.0, la mayoría de los constructores de QChar son de tipo « explicit ». Esto se hace para evitar errores peligrosos al mezclar accidentalmente tipos enteros y cadenas.
Para obtener más información, consulta «Acerca de la base de datos de caracteres Unicode».
Véase también Unicode, QString y QLatin1Char.
Documentación sobre los tipos de miembros
enum QChar::Category
Esta enumeración asigna las categorías de caracteres Unicode.
Los siguientes caracteres son normativos en Unicode:
| Constante | Valor | Descripción |
|---|---|---|
QChar::Mark_NonSpacing | 0 | Nombre de clase Unicode Mn |
QChar::Mark_SpacingCombining | 1 | Nombre de la clase Unicode Mn |
QChar::Mark_Enclosing | 2 | Nombre de la clase Unicode Me |
QChar::Number_DecimalDigit | 3 | Nombre de clase Unicode Nd |
QChar::Number_Letter | 4 | Nombre de clase Unicode Nl |
QChar::Number_Other | 5 | Nombre de clase Unicode No |
QChar::Separator_Space | 6 | Nombre de clase Unicode Zs |
QChar::Separator_Line | 7 | Nombre de clase Unicode Zl |
QChar::Separator_Paragraph | 8 | Nombre de clase Unicode Zp |
QChar::Other_Control | 9 | Nombre de clase Unicode Cc |
QChar::Other_Format | 10 | Nombre de clase Unicode Cf |
QChar::Other_Surrogate | 11 | Nombre de clase Unicode Cs |
QChar::Other_PrivateUse | 12 | Nombre de clase Unicode Co |
QChar::Other_NotAssigned | 13 | Nombre de clase Unicode Cn |
Las siguientes categorías son informativas en Unicode:
| Constante | Valor | Descripción |
|---|---|---|
QChar::Letter_Uppercase | 14 | Nombre de clase Unicode Lu |
QChar::Letter_Lowercase | 15 | Nombre de la clase Unicode Ll |
QChar::Letter_Titlecase | 16 | Nombre de clase Unicode Lt |
QChar::Letter_Modifier | 17 | Nombre de clase Unicode Lm |
QChar::Letter_Other | 18 | Nombre de clase Unicode: Lo |
QChar::Punctuation_Connector | 19 | Nombre de clase Unicode: Pc |
QChar::Punctuation_Dash | 20 | Nombre de clase Unicode Pd |
QChar::Punctuation_Open | 21 | Nombre de clase Unicode: Ps |
QChar::Punctuation_Close | 22 | Nombre de clase Unicode: Pe |
QChar::Punctuation_InitialQuote | 23 | Nombre de clase Unicode Pi |
QChar::Punctuation_FinalQuote | 24 | Nombre de clase Unicode Pf |
QChar::Punctuation_Other | 25 | Nombre de clase Unicode Po |
QChar::Symbol_Math | 26 | Nombre de clase Unicode Sm |
QChar::Symbol_Currency | 27 | Nombre de clase Unicode: Sc |
QChar::Symbol_Modifier | 28 | Nombre de clase Unicode Sk |
QChar::Symbol_Other | 29 | Nombre de clase Unicode So |
Véase también category().
enum QChar::Decomposition
Este tipo de enumeración define los atributos de descomposición de Unicode. Consulte el estándar Unicode para obtener una descripción de los valores.
| Constante | Valor |
|---|---|
QChar::NoDecomposition | 0 |
QChar::Canonical | 1 |
QChar::Circle | 8 |
QChar::Compat | 16 |
QChar::Final | 6 |
QChar::Font | 2 |
QChar::Fraction | 17 |
QChar::Initial | 4 |
QChar::Isolated | 7 |
QChar::Medial | 5 |
QChar::Narrow | 13 |
QChar::NoBreak | 3 |
QChar::Small | 14 |
QChar::Square | 15 |
QChar::Sub | 10 |
QChar::Super | 9 |
QChar::Vertical | 11 |
QChar::Wide | 12 |
Véase también decomposition().
enum QChar::Direction
Este tipo de enumeración define los atributos de dirección de Unicode. Consulte el estándar Unicode para obtener una descripción de los valores.
Para ajustarse a las convenciones de nomenclatura de C/C++, se antepone «Dir» a los códigos utilizados en el estándar Unicode.
| Constante | Valor |
|---|---|
QChar::DirAL | 13 |
QChar::DirAN | 5 |
QChar::DirB | 7 |
QChar::DirBN | 18 |
QChar::DirCS | 6 |
QChar::DirEN | 2 |
QChar::DirES | 3 |
QChar::DirET | 4 |
QChar::DirFSI (since Qt 5.3) | 21 |
QChar::DirL | 0 |
QChar::DirLRE | 11 |
QChar::DirLRI (since Qt 5.3) | 19 |
QChar::DirLRO | 12 |
QChar::DirNSM | 17 |
QChar::DirON | 10 |
QChar::DirPDF | 16 |
QChar::DirPDI (since Qt 5.3) | 22 |
QChar::DirR | 1 |
QChar::DirRLE | 14 |
QChar::DirRLI (since Qt 5.3) | 20 |
QChar::DirRLO | 15 |
QChar::DirS | 8 |
QChar::DirWS | 9 |
Véase también direction().
enum QChar::JoiningType
desde la versión 5.3
Este tipo de enumeración define los atributos de tipo de unión de Unicode. Consulta el estándar Unicode para obtener una descripción de los valores.
Para cumplir con las convenciones de nomenclatura de C/C++, se antepone «Joining_» a los códigos utilizados en el estándar Unicode.
| Constante | Valor |
|---|---|
QChar::Joining_None | 0 |
QChar::Joining_Causing | 1 |
QChar::Joining_Dual | 2 |
QChar::Joining_Right | 3 |
QChar::Joining_Left | 4 |
QChar::Joining_Transparent | 5 |
Véase también joiningType().
enum QChar::Script
Este tipo de enumeración define los valores de la propiedad «script» de Unicode.
Para obtener más información sobre los valores de la propiedad «script» de Unicode, consulte el Anexo n.º 24 del Estándar Unicode.
Para cumplir con las convenciones de nomenclatura de C/C++, se antepone «Script_» a los códigos utilizados en el Estándar Unicode.
| Constante | Valor | Descripción |
|---|---|---|
QChar::Script_Unknown | 0 | Para puntos de código no asignados, de uso privado, que no son caracteres y sustitutos. |
QChar::Script_Inherited | 1 | Para caracteres que pueden utilizarse con varios alfabetos y que heredan su alfabeto de los caracteres precedentes. Entre ellos se incluyen los signos de separación no espaciados, los signos de encerrado y los caracteres de unión/no unión de ancho cero. |
QChar::Script_Common | 2 | Para caracteres que pueden utilizarse con varios alfabetos y que no heredan su alfabeto de los caracteres precedentes. |
QChar::Script_Adlam (since Qt 5.11) | 132 | |
QChar::Script_Ahom (since Qt 5.6) | 126 | |
QChar::Script_AnatolianHieroglyphs (since Qt 5.6) | 127 | |
QChar::Script_Arabic | 8 | |
QChar::Script_Armenian | 6 | |
QChar::Script_Avestan | 80 | |
QChar::Script_Balinese | 62 | |
QChar::Script_Bamum | 84 | |
QChar::Script_BassaVah (since Qt 5.5) | 104 | |
QChar::Script_Batak | 93 | |
QChar::Script_Bengali | 12 | |
QChar::Script_BeriaErfe (since Qt 6.11) | 174 | |
QChar::Script_Bhaiksuki (since Qt 5.11) | 133 | |
QChar::Script_Bopomofo | 36 | |
QChar::Script_Brahmi | 94 | |
QChar::Script_Braille | 54 | |
QChar::Script_Buginese | 55 | |
QChar::Script_Buhid | 44 | |
QChar::Script_CanadianAboriginal | 29 | |
QChar::Script_Carian | 75 | |
QChar::Script_CaucasianAlbanian (since Qt 5.5) | 103 | |
QChar::Script_Chakma | 96 | |
QChar::Script_Cham | 77 | |
QChar::Script_Cherokee | 28 | |
QChar::Script_Chorasmian (since Qt 5.15) | 153 | |
QChar::Script_Coptic | 46 | |
QChar::Script_Cuneiform | 63 | |
QChar::Script_Cypriot | 53 | |
QChar::Script_CyproMinoan (since Qt 6.3) | 157 | |
QChar::Script_Cyrillic | 5 | |
QChar::Script_Deseret | 41 | |
QChar::Script_Devanagari | 11 | |
QChar::Script_DivesAkuru (since Qt 5.15) | 154 | |
QChar::Script_Dogra (since Qt 5.15) | 142 | |
QChar::Script_Duployan (since Qt 5.5) | 105 | |
QChar::Script_EgyptianHieroglyphs | 81 | |
QChar::Script_Elbasan (since Qt 5.5) | 106 | |
QChar::Script_Elymaic (since Qt 5.15) | 149 | |
QChar::Script_Ethiopic | 27 | |
QChar::Script_Garay (since Qt 6.9) | 164 | |
QChar::Script_Georgian | 25 | |
QChar::Script_Glagolitic | 57 | |
QChar::Script_Gothic | 40 | |
QChar::Script_Grantha (since Qt 5.5) | 107 | |
QChar::Script_Greek | 4 | |
QChar::Script_Gujarati | 14 | |
QChar::Script_GunjalaGondi (since Qt 5.15) | 143 | |
QChar::Script_Gurmukhi | 13 | |
QChar::Script_GurungKhema (since Qt 6.9) | 165 | |
QChar::Script_Han | 37 | |
QChar::Script_Hangul | 26 | |
QChar::Script_HanifiRohingya (since Qt 5.15) | 144 | |
QChar::Script_Hanunoo | 43 | |
QChar::Script_Hatran (since Qt 5.6) | 128 | |
QChar::Script_Hebrew | 7 | |
QChar::Script_Hiragana | 34 | |
QChar::Script_ImperialAramaic | 87 | |
QChar::Script_InscriptionalPahlavi | 90 | |
QChar::Script_InscriptionalParthian | 89 | |
QChar::Script_Javanese | 85 | |
QChar::Script_Kaithi | 92 | |
QChar::Script_Kannada | 18 | |
QChar::Script_Katakana | 35 | |
QChar::Script_Kawi (since Qt 6.5) | 162 | |
QChar::Script_KayahLi | 72 | |
QChar::Script_Kharoshthi | 61 | |
QChar::Script_KhitanSmallScript (since Qt 5.15) | 155 | |
QChar::Script_Khmer | 32 | |
QChar::Script_Khojki (since Qt 5.5) | 109 | |
QChar::Script_Khudawadi (since Qt 5.5) | 123 | |
QChar::Script_KiratRai (since Qt 6.9) | 166 | |
QChar::Script_Lao | 22 | |
QChar::Script_Latin | 3 | |
QChar::Script_Lepcha | 68 | |
QChar::Script_Limbu | 47 | |
QChar::Script_LinearA (since Qt 5.5) | 110 | |
QChar::Script_LinearB | 49 | |
QChar::Script_Lisu | 83 | |
QChar::Script_Lycian | 74 | |
QChar::Script_Lydian | 76 | |
QChar::Script_Mahajani (since Qt 5.5) | 111 | |
QChar::Script_Makasar (since Qt 5.15) | 145 | |
QChar::Script_Malayalam | 19 | |
QChar::Script_Mandaic | 95 | |
QChar::Script_Manichaean (since Qt 5.5) | 112 | |
QChar::Script_Marchen (since Qt 5.11) | 134 | |
QChar::Script_MasaramGondi (since Qt 5.11) | 138 | |
QChar::Script_Medefaidrin (since Qt 5.15) | 146 | |
QChar::Script_MeeteiMayek | 86 | |
QChar::Script_MendeKikakui (since Qt 5.5) | 113 | |
QChar::Script_MeroiticCursive | 97 | |
QChar::Script_MeroiticHieroglyphs | 98 | |
QChar::Script_Miao | 99 | |
QChar::Script_Modi (since Qt 5.5) | 114 | |
QChar::Script_Mongolian | 33 | |
QChar::Script_Mro (since Qt 5.5) | 115 | |
QChar::Script_Multani (since Qt 5.6) | 129 | |
QChar::Script_Myanmar | 24 | |
QChar::Script_Nabataean (since Qt 5.5) | 117 | |
QChar::Script_NagMundari (since Qt 6.3) | 163 | |
QChar::Script_Nandinagari (since Qt 5.15) | 150 | |
QChar::Script_Newa (since Qt 5.11) | 135 | |
QChar::Script_NewTaiLue | 56 | |
QChar::Script_Nko | 66 | |
QChar::Script_Nushu (since Qt 5.11) | 139 | |
QChar::Script_NyiakengPuachueHmong (since Qt 5.15) | 151 | |
QChar::Script_Ogham | 30 | |
QChar::Script_OlChiki | 69 | |
QChar::Script_OlOnal (since Qt 6.9) | 167 | |
QChar::Script_OldHungarian (since Qt 5.6) | 130 | |
QChar::Script_OldItalic | 39 | |
QChar::Script_OldNorthArabian (since Qt 5.5) | 116 | |
QChar::Script_OldPermic (since Qt 5.5) | 120 | |
QChar::Script_OldPersian | 60 | |
QChar::Script_OldSogdian (since Qt 5.15) | 147 | |
QChar::Script_OldSouthArabian | 88 | |
QChar::Script_OldTurkic | 91 | |
QChar::Script_OldUyghur (since Qt 6.3) | 158 | |
QChar::Script_Oriya | 15 | |
QChar::Script_Osage (since Qt 5.11) | 136 | |
QChar::Script_Osmanya | 52 | |
QChar::Script_PahawhHmong (since Qt 5.5) | 108 | |
QChar::Script_Palmyrene (since Qt 5.5) | 118 | |
QChar::Script_PauCinHau (since Qt 5.5) | 119 | |
QChar::Script_PhagsPa | 65 | |
QChar::Script_Phoenician | 64 | |
QChar::Script_PsalterPahlavi (since Qt 5.5) | 121 | |
QChar::Script_Rejang | 73 | |
QChar::Script_Runic | 31 | |
QChar::Script_Samaritan | 82 | |
QChar::Script_Saurashtra | 71 | |
QChar::Script_Sharada | 100 | |
QChar::Script_Shavian | 51 | |
QChar::Script_Siddham (since Qt 5.5) | 122 | |
QChar::Script_Sidetic (since Qt 6.11) | 171 | |
QChar::Script_SignWriting (since Qt 5.6) | 131 | |
QChar::Script_Sinhala | 20 | |
QChar::Script_Sogdian (since Qt 5.15) | 148 | |
QChar::Script_SoraSompeng | 101 | |
QChar::Script_Soyombo (since Qt 5.11) | 140 | |
QChar::Script_Sundanese | 67 | |
QChar::Script_Sunuwar (since Qt 6.9) | 168 | |
QChar::Script_SylotiNagri | 59 | |
QChar::Script_Syriac | 9 | |
QChar::Script_Tagalog | 42 | |
QChar::Script_Tagbanwa | 45 | |
QChar::Script_TaiLe | 48 | |
QChar::Script_TaiTham | 78 | |
QChar::Script_TaiViet | 79 | |
QChar::Script_TaiYo (since Qt 6.11) | 172 | |
QChar::Script_Takri | 102 | |
QChar::Script_Tamil | 16 | |
QChar::Script_Tangut (since Qt 5.11) | 137 | |
QChar::Script_Tangsa (since Qt 6.3) | 159 | |
QChar::Script_Telugu | 17 | |
QChar::Script_Thaana | 10 | |
QChar::Script_Thai | 21 | |
QChar::Script_Tibetan | 23 | |
QChar::Script_Tifinagh | 58 | |
QChar::Script_Tirhuta (since Qt 5.5) | 124 | |
QChar::Script_Todhri (since Qt 6.9) | 169 | |
QChar::Script_TolongSiki (since Qt 6.11) | 173 | |
QChar::Script_Toto (since Qt 6.3) | 160 | |
QChar::Script_TuluTigalari (since Qt 6.9) | 170 | |
QChar::Script_Ugaritic | 50 | |
QChar::Script_Vai | 70 | |
QChar::Script_Vithkuqi (since Qt 6.3) | 161 | |
QChar::Script_Wancho (since Qt 5.15) | 152 | |
QChar::Script_WarangCiti (since Qt 5.5) | 125 | |
QChar::Script_Yezidi (since Qt 5.15) | 156 | |
QChar::Script_Yi | 38 | |
QChar::Script_ZanabazarSquare (since Qt 5.11) | 141 |
Véase también script().
enum QChar::SpecialCharacter
| Constante | Valor | Descripción |
|---|---|---|
QChar::Null | 0x0000 | Un « QChar » con este valor isNull(). |
QChar::Tabulation | 0x0009 | Tabulación de caracteres. |
QChar::LineFeed | 0x000a | |
QChar::FormFeed | 0x000c | |
QChar::CarriageReturn | 0x000d | |
QChar::Space | 0x0020 | |
QChar::Nbsp | 0x00a0 | Espacio no separable. |
QChar::SoftHyphen | 0x00ad | |
QChar::ReplacementCharacter | 0xfffd | Carácter que aparece cuando una fuente no dispone de glifo para un determinado punto de código. A menudo se utiliza un signo de interrogación especial. Los códecs utilizan este punto de código cuando los datos de entrada no pueden representarse en Unicode. |
QChar::ObjectReplacementCharacter | 0xfffc | Se utiliza para representar un objeto, como una imagen, cuando dichos objetos no se pueden mostrar. |
QChar::ByteOrderMark | 0xfeff | |
QChar::ByteOrderSwapped | 0xfffe | |
QChar::ParagraphSeparator | 0x2029 | |
QChar::LineSeparator | 0x2028 | |
QChar::VisualTabCharacter (since Qt 6.2) | 0x2192 | Se utiliza para representar una tabulación mediante una flecha horizontal. |
QChar::LastValidCodePoint | 0x10ffff |
enum QChar::UnicodeVersion
Especifica en qué versión del estándar Unicode se introdujo un determinado carácter.
| Constante | Valor | Descripción |
|---|---|---|
QChar::Unicode_1_1 | 1 | Versión 1.1 |
QChar::Unicode_2_0 | 2 | Versión 2.0 |
QChar::Unicode_2_1_2 | 3 | Versión 2.1.2 |
QChar::Unicode_3_0 | 4 | Versión 3.0 |
QChar::Unicode_3_1 | 5 | Versión 3.1 |
QChar::Unicode_3_2 | 6 | Versión 3.2 |
QChar::Unicode_4_0 | 7 | Versión 4.0 |
QChar::Unicode_4_1 | 8 | Versión 4.1 |
QChar::Unicode_5_0 | 9 | Versión 5.0 |
QChar::Unicode_5_1 | 10 | Versión 5.1 |
QChar::Unicode_5_2 | 11 | Versión 5.2 |
QChar::Unicode_6_0 | 12 | Versión 6.0 |
QChar::Unicode_6_1 | 13 | Versión 6.1 |
QChar::Unicode_6_2 | 14 | Versión 6.2 |
QChar::Unicode_6_3 (since Qt 5.3) | 15 | Versión 6.3 |
QChar::Unicode_7_0 (since Qt 5.5) | 16 | Versión 7.0 |
QChar::Unicode_8_0 (since Qt 5.6) | 17 | Versión 8.0 |
QChar::Unicode_9_0 (since Qt 5.11) | 18 | Versión 9.0 |
QChar::Unicode_10_0 (since Qt 5.11) | 19 | Versión 10.0 |
QChar::Unicode_11_0 (since Qt 5.15) | 20 | Versión 11.0 |
QChar::Unicode_12_0 (since Qt 5.15) | 21 | Versión 12.0 |
QChar::Unicode_12_1 (since Qt 5.15) | 22 | Versión 12.1 |
QChar::Unicode_13_0 (since Qt 5.15) | 23 | Versión 13.0 |
QChar::Unicode_14_0 (since Qt 6.3) | 24 | Versión 14.0 |
QChar::Unicode_15_0 (since Qt 6.5) | 25 | Versión 15.0 |
QChar::Unicode_15_1 (since Qt 6.8) | 26 | Versión 15.1 |
QChar::Unicode_16_0 (since Qt 6.9) | 27 | Versión 16.0 |
QChar::Unicode_17_0 (since Qt 6.11) | 28 | Versión 17.0 |
QChar::Unicode_Unassigned | 0 | El valor no está asignado a ningún carácter en la versión 8.0 de Unicode. |
Véase también unicodeVersion() y currentUnicodeVersion().
Documentación de funciones de miembro
[constexpr noexcept] QChar::QChar()
Crea un objeto QChar nulo («\0 »).
Véase también isNull().
[constexpr noexcept] QChar::QChar(QChar::SpecialCharacter ch)
Crea un objeto `QChar` con el valor de carácter predefinido ` ch`.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo lo que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[constexpr noexcept] QChar::QChar(QLatin1Char ch)
Crea un objeto `QChar` correspondiente al carácter ASCII/Latin-1 ch.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo lo que se convierta implícitamente a ese tipo. Una solución compatible con versiones anteriores consiste en realizar una conversión explícita a uno de los tipos de argumento admitidos por los constructores de QChar.
[constexpr noexcept] QChar::QChar(char ch)
Crea un objeto `QChar` correspondiente al carácter ASCII/Latin-1 ch.
Nota: Este constructor no está disponible cuando se define QT_NO_CAST_FROM_ASCII.
Nota: Desde Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo lo que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
Véase también QT_NO_CAST_FROM_ASCII.
[constexpr noexcept] QChar::QChar(char16_t ch)
Crea un objeto `QChar` correspondiente al carácter UTF-16 ` ch`.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no cualquier tipo que se convierta implícitamente a él. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[implicit] QChar::QChar(char32_t code)
Crea un objeto `QChar` para el carácter con el punto de código Unicode code.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no cualquier tipo que se convierta implícitamente a él. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[explicit constexpr noexcept] QChar::QChar(int code)
Crea un objeto `QChar` para el carácter con el punto de código Unicode code.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo lo que se convierta implícitamente a él. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[constexpr noexcept] QChar::QChar(short code)
Crea un objeto `QChar` para el carácter con el punto de código Unicode code.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo lo que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[explicit constexpr noexcept] QChar::QChar(uchar ch)
Crea un objeto `QChar` correspondiente al carácter ASCII/Latin-1 ch.
Nota: Este constructor no está disponible cuando se define QT_NO_CAST_FROM_ASCII o QT_RESTRICTED_CAST_FROM_ASCII.
Nota: Desde Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo del argumento del constructor y no todo lo que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar una conversión explícita a uno de los tipos de argumento admitidos por los constructores de `QChar`.
Véase también QT_NO_CAST_FROM_ASCII y QT_RESTRICTED_CAST_FROM_ASCII.
[explicit constexpr noexcept] QChar::QChar(uint code)
Crea un objeto `QChar` para el carácter con el punto de código Unicode code.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo lo que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[constexpr noexcept] QChar::QChar(ushort code)
Crea un objeto `QChar` para el carácter con el punto de código Unicode code.
Nota: Desde Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no todo aquello que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[constexpr noexcept] QChar::QChar(wchar_t ch)
Crea un objeto QChar correspondiente al carácter ancho ch.
Nota: Este constructor solo está disponible en Windows.
Nota: A partir de Qt 6.9, las conversiones implícitas están desactivadas para este constructor. Esto significa que solo acepta el tipo de argumento del constructor y no cualquier valor que se convierta implícitamente a dicho tipo. Una solución compatible con versiones anteriores consiste en realizar un casting explícito a uno de los tipos de argumento admitidos por los constructores de QChar.
[explicit constexpr noexcept] QChar::QChar(uchar cell, uchar row)
Crea un objeto `QChar` para la celda Unicode cell de la fila row.
Véanse también cell() y row().
[noexcept] QChar::Category QChar::category() const
Devuelve la categoría del personaje.
[static noexcept] QChar::Category QChar::category(char32_t ucs4)
Devuelve la categoría del carácter codificado en UCS-4 especificado por ` ucs4`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] uchar QChar::cell() const
Devuelve la celda (byte menos significativo) del carácter Unicode.
Véase también row().
[noexcept] unsigned char QChar::combiningClass() const
Devuelve la clase de combinación del carácter tal y como se define en el estándar Unicode. Esto resulta útil principalmente como indicación de posicionamiento para los signos adjuntos a un carácter base.
El motor de renderizado de texto de Qt utiliza esta información para colocar correctamente los signos no espaciadores alrededor de un carácter base.
[static noexcept] unsigned char QChar::combiningClass(char32_t ucs4)
Devuelve la clase de combinación del carácter codificado en UCS-4 especificado por ` ucs4`, tal y como se define en el estándar Unicode.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[static noexcept] QChar::UnicodeVersion QChar::currentUnicodeVersion()
Devuelve la versión más reciente de Unicode compatible.
QString QChar::decomposition() const
Descompone un carácter en sus partes constitutivas. Devuelve una cadena vacía si no es posible descomponerlo.
[static] QString QChar::decomposition(char32_t ucs4)
Descompone el carácter codificado en UCS-4 especificado por ` ucs4 ` en sus partes constitutivas. Devuelve una cadena vacía si no existe ninguna descomposición.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[noexcept] QChar::Decomposition QChar::decompositionTag() const
Devuelve la etiqueta que define la composición del carácter. Devuelve « QChar::NoDecomposition » si no existe ninguna descomposición.
[static noexcept] QChar::Decomposition QChar::decompositionTag(char32_t ucs4)
Devuelve la etiqueta que define la composición del carácter codificado en UCS-4 especificado por ucs4. Devuelve QChar::NoDecomposition si no existe ninguna descomposición.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[noexcept] int QChar::digitValue() const
Devuelve el valor numérico del dígito, o -1 si el carácter no es un dígito.
[static noexcept] int QChar::digitValue(char32_t ucs4)
Devuelve el valor numérico del dígito especificado por el carácter codificado en UCS-4, ucs4, o -1 si el carácter no es un dígito.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[noexcept] QChar::Direction QChar::direction() const
Devuelve la dirección del personaje.
[static noexcept] QChar::Direction QChar::direction(char32_t ucs4)
Devuelve la dirección del carácter codificado en UCS-4 especificado por ` ucs4`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[static constexpr noexcept] QChar QChar::fromLatin1(char c)
Convierte el carácter Latin-1 « c » en su equivalente « QChar ». Esto resulta útil sobre todo para software no internacionalizado.
Una alternativa es utilizar QLatin1Char.
Véanse también toLatin1() y unicode().
[static constexpr noexcept, since 6.0] QChar QChar::fromUcs2(char16_t c)
Crea un objeto ` QChar ` a partir de un carácter UTF-16 ` c`.
Esta función se introdujo en Qt 6.0.
Véase también fromUcs4().
[static constexpr noexcept, since 6.0] auto QChar::fromUcs4(char32_t c)
Devuelve una estructura anónima que
- contiene una matriz de tipo «
char16_t chars[2]», - que se puede convertir implícitamente en un ` QStringView` y
- se puede recorrer con un bucle «for» de rango de C++11.
Si ` c ` requiere sustitutos, ` chars[0] ` contiene el sustituto alto y ` chars[1] ` el sustituto bajo, y el ` QStringView ` tiene tamaño 2. De lo contrario, ` chars[0] ` contiene ` c ` y ` chars[1] ` es ` null`, y el ` QStringView ` tiene tamaño 1.
Esto permite utilizar fácilmente el resultado:
for (char16_t c16 : QChar::fromUcs4(ch))
use(c16);Esta función se introdujo en Qt 6.0.
Véase también fromUcs2() y requiresSurrogates().
[noexcept] bool QChar::hasMirrored() const
Devuelve ` true ` si el carácter debe invertirse cuando se invierte la dirección del texto; en caso contrario, devuelve ` false`.
Una variante ligeramente más rápida de (ch.mirroredChar() != ch).
Véase también mirroredChar().
[static noexcept] bool QChar::hasMirrored(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` debe invertirse cuando se invierte la dirección del texto; en caso contrario, devuelve ` false`.
Es una variante ligeramente más rápida de (QChar::mirroredChar(ucs4) != ucs4).
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo « uint ».
Esta es una función sobrecargada.
Véase también mirroredChar().
[static constexpr noexcept] char16_t QChar::highSurrogate(char32_t ucs4)
Devuelve la parte de sustituto alto de un punto de código codificado en UCS-4. El resultado devuelto es indefinido si ucs4 es menor que 0x10000.
Nota: Antes de Qt 6, esta función tomaba un argumento de tipo « uint » y devolvía « ushort ».
[constexpr noexcept] bool QChar::isDigit() const
Devuelve « true » si el carácter es un dígito decimal (Number_DecimalDigit); en caso contrario, devuelve « false ».
Véase también isNumber().
[static constexpr noexcept] bool QChar::isDigit(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es un dígito decimal (Number_DecimalDigit); en caso contrario, devuelve ` false`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
Véase también isNumber().
[constexpr noexcept] bool QChar::isHighSurrogate() const
Devuelve « true » si el « QChar » es la parte alta de un sustituto UTF-16 (por ejemplo, si su punto de código está en el intervalo [0xd800..0xdbff]); en caso contrario, devuelve «false».
[static constexpr noexcept] bool QChar::isHighSurrogate(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » es la parte alta de un sustituto UTF-16 (por ejemplo, si su punto de código está en el intervalo [0xd800..0xdbff]); en caso contrario, devuelve «false».
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isLetter() const
Devuelve « true » si el carácter es una letra (categorías «Letter_*»); en caso contrario, devuelve « false ».
[static constexpr noexcept] bool QChar::isLetter(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » es una letra (categorías «Letter_*»); en caso contrario, devuelve « false ».
Nota: Antes de Qt 6, esta función tomaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isLetterOrNumber() const
Devuelve « true » si el carácter es una letra o un número (categorías «Letter_*» o «Number_*»); en caso contrario, devuelve « false ».
[static constexpr noexcept] bool QChar::isLetterOrNumber(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » es una letra o un número (categorías «Letter_*» o «Number_*»); en caso contrario, devuelve « false ».
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isLowSurrogate() const
Devuelve ` true ` si el ` QChar ` es la parte baja de un sustituto UTF-16 (por ejemplo, si su punto de código está en el intervalo [0xdc00..0xdfff]); en caso contrario, devuelve `false`.
[static constexpr noexcept] bool QChar::isLowSurrogate(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es la parte baja de un sustituto UTF-16 (por ejemplo, si su punto de código está en el intervalo [0xdc00..0xdfff]); en caso contrario, devuelve `false`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isLower() const
Devuelve « true » si el carácter es una letra minúscula; por ejemplo, « category » () da como resultado « Letter_Lowercase ».
Véase también isUpper(), toLower() y toUpper().
[static constexpr noexcept] bool QChar::isLower(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es una letra minúscula; por ejemplo, ` category()` es ` Letter_Lowercase`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
Véase también isUpper(), toLower() y toUpper().
[noexcept] bool QChar::isMark() const
Devuelve « true » si el carácter es una marca (categorías Mark_*); en caso contrario, devuelve « false ».
Consulte QChar::Category para obtener más información sobre las marcas.
[static noexcept] bool QChar::isMark(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es una marca (categorías `Mark_*`); en caso contrario, devuelve ` false`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isNonCharacter() const
Devuelve ` true ` si el ` QChar ` no es un carácter; en caso contrario, devuelve `false`.
Unicode cuenta con un número determinado de puntos de código clasificados como «no caracteres»: es decir, pueden utilizarse con fines internos en las aplicaciones, pero no pueden emplearse para el intercambio de texto. Se trata de las dos últimas entradas de cada plano Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff], etc.), así como de las entradas del rango [0xfdd0..0xfdef].
[static constexpr noexcept] bool QChar::isNonCharacter(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » no es un carácter; en caso contrario, devuelve «false».
Unicode cuenta con un número determinado de puntos de código clasificados como «no caracteres»: es decir, pueden utilizarse con fines internos en las aplicaciones, pero no para el intercambio de texto. Se trata de las dos últimas entradas de cada plano Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff], etc.), así como de las entradas del rango [0xfdd0..0xfdef].
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo « uint ».
Se trata de una función sobrecargada.
[constexpr noexcept] bool QChar::isNull() const
Devuelve ` true ` si el carácter es el carácter Unicode 0x0000 («\0 »); en caso contrario, devuelve ` false`.
[constexpr noexcept] bool QChar::isNumber() const
Devuelve ` true ` si el carácter es un número (categorías `Number_*`, no solo del 0 al 9); en caso contrario, devuelve ` false`.
Véase también isDigit().
[static constexpr noexcept] bool QChar::isNumber(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es un número (categorías `Number_*`, no solo del 0 al 9); en caso contrario, devuelve ` false`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
Véase también isDigit().
[noexcept] bool QChar::isPrint() const
Devuelve « true » si el carácter es imprimible; en caso contrario, devuelve « false ». Se trata de cualquier carácter que no pertenezca a la categoría « Other_*».
Ten en cuenta que esto no indica si el carácter está disponible en una fuente concreta.
[static noexcept] bool QChar::isPrint(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » es un carácter imprimible; en caso contrario, devuelve « false ». Se trata de cualquier carácter que no pertenezca a la categoría « Other_*».
Ten en cuenta que esto no indica si el carácter está disponible en una fuente concreta.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo « uint ».
Esta es una función sobrecargada.
[noexcept] bool QChar::isPunct() const
Devuelve « true » si el carácter es un signo de puntuación (categorías «Punctuation_*»); en caso contrario, devuelve « false ».
[static noexcept] bool QChar::isPunct(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es un signo de puntuación (categorías `Punctuation_*`); en caso contrario, devuelve ` false`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isSpace() const
Devuelve « true » si el carácter es un carácter separador (categorías «Separator_*» o determinados puntos de código de la categoría « Other_Control »); en caso contrario, devuelve « false ».
[static constexpr noexcept] bool QChar::isSpace(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » es un carácter separador (categorías «Separator_*» o determinados puntos de código de la categoría « Other_Control »); en caso contrario, devuelve « false ».
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Se trata de una función sobrecargada.
[constexpr noexcept] bool QChar::isSurrogate() const
Devuelve « true » si el objeto « QChar » contiene un punto de código que se encuentre en la parte alta o en la parte baja del rango de sustitutos UTF-16 (por ejemplo, si su punto de código está en el rango [0xd800..0xdfff]); en caso contrario, devuelve «false».
[static constexpr noexcept] bool QChar::isSurrogate(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » contiene un punto de código que se encuentre en la parte alta o en la parte baja del rango de caracteres sustitutos de UTF-16 (por ejemplo, si su punto de código está en el rango [0xd800..0xdfff]); en caso contrario, devuelve «false».
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[noexcept] bool QChar::isSymbol() const
Devuelve ` true ` si el carácter es un símbolo (categorías `Symbol_*`); en caso contrario, devuelve ` false`.
[static noexcept] bool QChar::isSymbol(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es un símbolo (categorías `Symbol_*`); en caso contrario, devuelve ` false`.
Nota: Antes de Qt 6, esta función tomaba un argumento de tipo uint.
Esta es una función sobrecargada.
[constexpr noexcept] bool QChar::isTitleCase() const
Devuelve « true » si el carácter es una letra en mayúscula inicial; por ejemplo, « category()» da como resultado « Letter_Titlecase ».
Véase también isLower(), toUpper(), toLower() y toTitleCase().
[static constexpr noexcept] bool QChar::isTitleCase(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` es una letra en mayúsculas de título; por ejemplo, ` category()` devuelve ` Letter_Titlecase`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
Véase también isLower(), toUpper(), toLower() y toTitleCase().
[constexpr noexcept] bool QChar::isUpper() const
Devuelve « true » si el carácter es una letra mayúscula; por ejemplo, « category » () da como resultado « Letter_Uppercase ».
Véase también isLower(), toUpper() y toLower().
[static constexpr noexcept] bool QChar::isUpper(char32_t ucs4)
Devuelve « true » si el carácter codificado en UCS-4 especificado por « ucs4 » es una letra mayúscula; por ejemplo, « category()» es « Letter_Uppercase ».
Nota: Antes de Qt 6, esta función tomaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
Véase también isLower(), toUpper() y toLower().
[noexcept] QChar::JoiningType QChar::joiningType() const
Devuelve información sobre los atributos de tipo de unión del carácter (necesaria para determinados idiomas, como el árabe o el siríaco).
[static noexcept] QChar::JoiningType QChar::joiningType(char32_t ucs4)
Devuelve información sobre los atributos de tipo de unión del carácter codificado en UCS-4 especificado por ucs4 (necesaria para determinados idiomas, como el árabe o el siríaco).
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Se trata de una función sobrecargada.
[static constexpr noexcept] char16_t QChar::lowSurrogate(char32_t ucs4)
Devuelve la parte sustitutiva baja de un punto de código codificado en UCS-4. El resultado devuelto es indefinido si ucs4 es menor que 0x10000.
Nota: Antes de Qt 6, esta función aceptaba un argumento ` uint ` y devolvía ` ushort`.
[noexcept] QChar QChar::mirroredChar() const
Devuelve el carácter reflejado si dicho carácter es un carácter reflejado; en caso contrario, devuelve el propio carácter.
Véase también hasMirrored().
[static noexcept] char32_t QChar::mirroredChar(char32_t ucs4)
Devuelve el carácter invertido si el carácter codificado en UCS-4 especificado por ` ucs4 ` es un carácter invertido; en caso contrario, devuelve el propio carácter.
Nota: Antes de Qt 6, esta función aceptaba un argumento ` uint ` y devolvía ` uint`.
Esta es una función sobrecargada.
Véase también hasMirrored().
[static constexpr noexcept] bool QChar::requiresSurrogates(char32_t ucs4)
Devuelve ` true ` si el carácter codificado en UCS-4 especificado por ` ucs4 ` puede dividirse en las partes alta y baja de un sustituto UTF-16 (por ejemplo, si su punto de código es mayor o igual que 0x10000); en caso contrario, devuelve `false`.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
[constexpr noexcept] uchar QChar::row() const
Devuelve la fila (el byte más significativo) del carácter Unicode.
Véase también cell().
[noexcept] QChar::Script QChar::script() const
Devuelve el valor de la propiedad «script» de Unicode correspondiente a este carácter.
[static noexcept] QChar::Script QChar::script(char32_t ucs4)
Devuelve el valor de la propiedad «script» de Unicode para el carácter especificado en su forma codificada en UCS-4 como ucs4.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint `.
Esta es una función sobrecargada.
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(char16_t high, char16_t low)
Convierte un par sustituto UTF-16 con los valores high y low especificados en su punto de código codificado en UCS-4.
Nota: Antes de Qt 6, esta función aceptaba argumentos de tipo ` ushort ` y devolvía ` uint`.
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(QChar high, QChar low)
Convierte un par sustituto UTF-16 (high, low) en su punto de código codificado en UCS-4.
Nota: Antes de Qt 6, esta función devolvía uint.
Se trata de una función sobrecargada.
[noexcept] QChar QChar::toCaseFolded() const
Devuelve el equivalente del carácter con mayúsculas y minúsculas unificadas. Para la mayoría de los caracteres Unicode, el resultado es el mismo que el de la función ` toLower()`.
[static noexcept] char32_t QChar::toCaseFolded(char32_t ucs4)
Devuelve el equivalente con mayúsculas y minúsculas del carácter codificado en UCS-4 especificado por ucs4. Para la mayoría de los caracteres Unicode, el resultado es el mismo que el de toLower().
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint ` y devolvía ` uint`.
Esta es una función sobrecargada.
[constexpr noexcept] char QChar::toLatin1() const
Devuelve el carácter Latin-1 equivalente al QChar, o 0. Esto resulta útil principalmente para software no internacionalizado.
Nota: Noes posible distinguir un carácter que no sea Latin-1 de un carácter 0 (NUL) de Latin-1. Es preferible utilizar unicode(), que no presenta esta ambigüedad.
Véase también unicode().
[noexcept] QChar QChar::toLower() const
Devuelve el equivalente en minúsculas si el carácter está en mayúsculas o en mayúsculas iniciales; en caso contrario, devuelve el propio carácter.
[static noexcept] char32_t QChar::toLower(char32_t ucs4)
Devuelve el equivalente en minúsculas del carácter codificado en UCS-4 especificado por ` ucs4 ` si el carácter está en mayúsculas o en mayúsculas de título; en caso contrario, devuelve el propio carácter.
Nota: Antes de Qt 6, esta función tomaba un argumento de tipo ` uint ` y devolvía ` uint`.
Esta es una función sobrecargada.
[noexcept] QChar QChar::toTitleCase() const
Devuelve el carácter equivalente en mayúsculas o minúsculas si el carácter está en minúscula o en mayúscula; en caso contrario, devuelve el propio carácter.
[static noexcept] char32_t QChar::toTitleCase(char32_t ucs4)
Devuelve el equivalente en mayúsculas y minúsculas del carácter codificado en UCS-4 especificado por ucs4 si el carácter es minúscula o mayúscula; en caso contrario, devuelve el propio carácter.
Nota: Antes de Qt 6, esta función aceptaba un argumento ` uint ` y devolvía ` uint`.
Esta es una función sobrecargada.
[noexcept] QChar QChar::toUpper() const
Devuelve el equivalente en mayúsculas si el carácter está en minúsculas o en mayúsculas iniciales; en caso contrario, devuelve el propio carácter.
Nota: Esta función también devuelve el carácter original en el caso excepcional de que la forma en mayúscula del carácter requiera dos o más caracteres.
Véase también QString::toUpper().
[static noexcept] char32_t QChar::toUpper(char32_t ucs4)
Devuelve el equivalente en mayúsculas del carácter codificado en UCS-4 especificado por ` ucs4 ` si el carácter está en minúsculas o en mayúsculas de título; en caso contrario, devuelve el propio carácter.
Nota: Esta función también devuelve el carácter original en el caso excepcional de que la forma en mayúsculas del carácter requiera dos o más caracteres.
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo ` uint ` y devolvía ` uint`.
Esta es una función sobrecargada.
Véase también QString::toUpper().
[constexpr noexcept] char16_t &QChar::unicode()
Devuelve una referencia al valor numérico Unicode de « QChar ».
[constexpr noexcept] char16_t QChar::unicode() const
Devuelve el valor numérico Unicode de la cadena « QChar ».
[noexcept] QChar::UnicodeVersion QChar::unicodeVersion() const
Devuelve la versión de Unicode en la que se introdujo este carácter.
[static noexcept] QChar::UnicodeVersion QChar::unicodeVersion(char32_t ucs4)
Devuelve la versión de Unicode en la que se introdujo el carácter especificado en su forma codificada en UCS-4 como « ucs4 ».
Nota: Antes de Qt 6, esta función aceptaba un argumento de tipo « uint ».
Esta es una función sobrecargada.
Elementos no miembros relacionados
[constexpr noexcept] bool operator!=(const QChar &c1, const QChar &c2)
Devuelve « true » si « c1 » y « c2 » no son el mismo carácter Unicode; en caso contrario, devuelve « false ».
[constexpr noexcept] bool operator<(const QChar &c1, const QChar &c2)
Devuelve ` true ` si el valor numérico Unicode de ` c1 ` es menor que el de ` c2`; en caso contrario, devuelve ` false`.
QDataStream &operator<<(QDataStream &out, QChar chr)
Escribe el carácter chr en el flujo out.
Véase también «Serialización detipos de datos de Qt».
[constexpr noexcept] bool operator<=(const QChar &c1, const QChar &c2)
Devuelve « true » si el valor numérico Unicode de « c1 » es menor o igual que el de « c2 »; en caso contrario, devuelve « false ».
[constexpr noexcept] bool operator==(const QChar &c1, const QChar &c2)
Devuelve « true » si « c1 » y « c2 » son el mismo carácter Unicode; en caso contrario, devuelve « false ».
[constexpr noexcept] bool operator>(const QChar &c1, const QChar &c2)
Devuelve « true » si el valor numérico Unicode de « c1 » es mayor que el de « c2 »; en caso contrario, devuelve « false ».
[constexpr noexcept] bool operator>=(const QChar &c1, const QChar &c2)
Devuelve « true » si el valor numérico Unicode de « c1 » es mayor o igual que el de « c2 »; en caso contrario, devuelve « false ».
QDataStream &operator>>(QDataStream &in, QChar &chr)
Lee un carácter del flujo « in » y lo asigna a la variable « chr ».
Véase también «Serialización detipos de datos de Qt».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.