En esta página

QChar Class

La clase QChar proporciona un carácter Unicode de 16 bits. Más...

Cabecera: #include <QChar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Esta clase es fuertemente comparable.

Esta clase es fuertemente comparable con char16_t, QString, QStringView, QLatin1StringView, y QUtf8StringView.

Esta clase es fuertemente comparable con const char *, QByteArray, y QByteArrayView.

El contenido de la matriz de bytes se interpreta como UTF-8.

Nota: Todas las funciones de esta clase son reentrantes.

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)
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 ninguna marca o estructura. Esta clase representa una entidad de este tipo. Es ligera, por lo que se puede utilizar en todas partes. La mayoría de los compiladores lo tratan como un unsigned short.

QChar proporciona un complemento completo de funciones de comprobación/clasificación, conversión a y desde otros formatos, conversión de Unicode compuesto a descompuesto, e intenta comparar y convertir mayúsculas y minúsculas si se le pide.

Las funciones de clasificación incluyen funciones como las de la cabecera estándar de C++ <cctype> (anteriormente <ctype.h>), pero operando en toda la gama de caracteres Unicode, no sólo para la gama ASCII. Todas ellas devuelven true si el carácter es de un determinado tipo; 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 puntuación), isMark() (Unicode Mark), isLetter() (una letra), isNumber() (cualquier tipo de carácter numérico, no sólo 0-9), isLetterOrNumber(), y isDigit() (dígitos decimales). Todos ellos son envoltorios de category() que devuelven la categoría definida por Unicode de cada carácter. Algunos de ellos también calculan las propiedades derivadas (por ejemplo isSpace() devuelve true si el carácter es de categoría Separator_* o 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 reflejarse cuando se imprime en su dirección de escritura "no natural".

Los caracteres Unicode compuestos (como ring) pueden convertirse en Unicode descompuesto ("a" seguida de "anillo arriba") utilizando decomposition().

En Unicode, la comparación no es necesariamente posible y la conversión de mayúsculas y minúsculas es muy difícil en el mejor de los casos. Unicode, que cubre el mundo "entero", también incluye la mayoría de los problemas de ordenación y mayúsculas/minúsculas del mundo. operator==() y sus amigos harán la comparación basándose puramente en el valor numérico Unicode (punto de código) de los caracteres, y toUpper() y toLower() harán los cambios de mayúsculas/minúsculas cuando el carácter tenga un equivalente mayúsculas/minúsculas bien definido. Para comparaciones dependientes de la localización, utilice QString::localeAwareCompare().

Las funciones de conversión incluyen unicode() (a un escalar), toLatin1() (a escalar, pero convierte todos los caracteres no latinos-1 a 0), row() (da la fila Unicode), cell() (da la celda Unicode), digitValue() (da el valor entero de cualquiera de los numerosos caracteres de dígitos), y una serie de constructores.

QChar proporciona constructores y operadores de conversión que facilitan la conversión a y desde los tradicionales chars de 8 bits. Si ha definido QT_NO_CAST_FROM_ASCII y QT_NO_CAST_TO_ASCII, como se explica en la documentación QString, tendrá que llamar explícitamente a fromLatin1(), o utilizar QLatin1Char, para construir un QChar a partir de un char de 8 bits, y tendrá que llamar a toLatin1() para recuperar el valor de 8 bits.

A partir de Qt 6.0, la mayoría de los constructores QChar son explicit. Esto se hace para evitar errores peligrosos al mezclar accidentalmente tipos integrales y cadenas.

Para más información, véase "Acerca de la base de datos de caracteres Unicode".

Véase también Unicode, QString, y QLatin1Char.

Documentación de tipos de miembros

enum QChar::Category

Este enum asigna las categorías de caracteres Unicode.

Los siguientes caracteres son normativos en Unicode:

ConstanteValorDescripción
QChar::Mark_NonSpacing0Nombre de clase Unicode Mn
QChar::Mark_SpacingCombining1Nombre de clase Unicode Mc
QChar::Mark_Enclosing2Nombre de clase Unicode Me
QChar::Number_DecimalDigit3Nombre de clase Unicode Nd
QChar::Number_Letter4Nombre de clase Unicode Nl
QChar::Number_Other5Nombre de clase Unicode No
QChar::Separator_Space6Nombre de clase Unicode Zs
QChar::Separator_Line7Nombre de clase Unicode Zl
QChar::Separator_Paragraph8Nombre de clase Unicode Zp
QChar::Other_Control9Nombre de clase Unicode Cc
QChar::Other_Format10Nombre de clase Unicode Cf
QChar::Other_Surrogate11Nombre de clase Unicode Cs
QChar::Other_PrivateUse12Nombre de clase Unicode Co
QChar::Other_NotAssigned13Nombre de clase Unicode Cn

Las siguientes categorías son informativas en Unicode:

ConstanteValorDescripción
QChar::Letter_Uppercase14Nombre de clase Unicode Lu
QChar::Letter_Lowercase15Nombre de clase Unicode Ll
QChar::Letter_Titlecase16Nombre de clase Unicode Lt
QChar::Letter_Modifier17Nombre de clase Unicode Lm
QChar::Letter_Other18Nombre de clase Unicode Lo
QChar::Punctuation_Connector19Nombre de clase Unicode Pc
QChar::Punctuation_Dash20Nombre de clase Unicode Pd
QChar::Punctuation_Open21Unicode class name Ps
QChar::Punctuation_Close22Nombre de clase Unicode Pe
QChar::Punctuation_InitialQuote23Nombre de clase Unicode Pi
QChar::Punctuation_FinalQuote24Nombre de clase Unicode Pf
QChar::Punctuation_Other25Nombre de clase Unicode Po
QChar::Symbol_Math26Nombre de clase Unicode Sm
QChar::Symbol_Currency27Nombre de clase Unicode Sc
QChar::Symbol_Modifier28Nombre de clase Unicode Sk
QChar::Symbol_Other29Nombre de clase Unicode So

Véase también category().

enum QChar::Decomposition

Este tipo enum define los atributos de descomposición Unicode. Consulte el estándar Unic ode para obtener una descripción de los valores.

ConstanteValor
QChar::NoDecomposition0
QChar::Canonical1
QChar::Circle8
QChar::Compat16
QChar::Final6
QChar::Font2
QChar::Fraction17
QChar::Initial4
QChar::Isolated7
QChar::Medial5
QChar::Narrow13
QChar::NoBreak3
QChar::Small14
QChar::Square15
QChar::Sub10
QChar::Super9
QChar::Vertical11
QChar::Wide12

Véase también decomposition().

enum QChar::Direction

Este tipo enum define los atributos de dirección Unicode. Véase el Estándar Unicode para 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.

ConstanteValor
QChar::DirAL13
QChar::DirAN5
QChar::DirB7
QChar::DirBN18
QChar::DirCS6
QChar::DirEN2
QChar::DirES3
QChar::DirET4
QChar::DirFSI (since Qt 5.3)21
QChar::DirL0
QChar::DirLRE11
QChar::DirLRI (since Qt 5.3)19
QChar::DirLRO12
QChar::DirNSM17
QChar::DirON10
QChar::DirPDF16
QChar::DirPDI (since Qt 5.3)22
QChar::DirR1
QChar::DirRLE14
QChar::DirRLI (since Qt 5.3)20
QChar::DirRLO15
QChar::DirS8
QChar::DirWS9

Véase también direction().

enum QChar::JoiningType

desde 5.3

Este tipo enum define los atributos del tipo de unión Unicode. Consulte el estándar Unicode para una descripción de los valores.

Para ajustarse a las convenciones de nomenclatura de C/C++, se antepone "Joining_" a los códigos utilizados en el estándar Unicode.

ConstanteValor
QChar::Joining_None0
QChar::Joining_Causing1
QChar::Joining_Dual2
QChar::Joining_Right3
QChar::Joining_Left4
QChar::Joining_Transparent5

Véase también joiningType().

enum QChar::Script

Este tipo enum define los valores de las propiedades de escritura Unicode.

Para más detalles sobre los valores de las propiedades de escritura Unicode véase el Anexo #24 del Estándar Unicode.

Para ajustarse a las convenciones de nomenclatura de C/C++, se antepone "Script_" a los códigos utilizados en el estándar Unicode.

ConstanteValorDescripción
QChar::Script_Unknown0Para puntos de código no asignados, de uso privado, no característicos y sustitutos.
QChar::Script_Inherited1Para caracteres que pueden utilizarse con varios guiones y que heredan su guión de los caracteres precedentes. Entre ellos se incluyen los signos de no espaciado, los signos de encierro y los caracteres de anchura cero de unión/no unión.
QChar::Script_Common2Para caracteres que pueden utilizarse con varios guiones y que no heredan su guión 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_Arabic8
QChar::Script_Armenian6
QChar::Script_Avestan80
QChar::Script_Balinese62
QChar::Script_Bamum84
QChar::Script_BassaVah (since Qt 5.5)104
QChar::Script_Batak93
QChar::Script_Bengali12
QChar::Script_BeriaErfe (since Qt 6.11)174
QChar::Script_Bhaiksuki (since Qt 5.11)133
QChar::Script_Bopomofo36
QChar::Script_Brahmi94
QChar::Script_Braille54
QChar::Script_Buginese55
QChar::Script_Buhid44
QChar::Script_CanadianAboriginal29
QChar::Script_Carian75
QChar::Script_CaucasianAlbanian (since Qt 5.5)103
QChar::Script_Chakma96
QChar::Script_Cham77
QChar::Script_Cherokee28
QChar::Script_Chorasmian (since Qt 5.15)153
QChar::Script_Coptic46
QChar::Script_Cuneiform63
QChar::Script_Cypriot53
QChar::Script_CyproMinoan (since Qt 6.3)157
QChar::Script_Cyrillic5
QChar::Script_Deseret41
QChar::Script_Devanagari11
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_EgyptianHieroglyphs81
QChar::Script_Elbasan (since Qt 5.5)106
QChar::Script_Elymaic (since Qt 5.15)149
QChar::Script_Ethiopic27
QChar::Script_Garay (since Qt 6.9)164
QChar::Script_Georgian25
QChar::Script_Glagolitic57
QChar::Script_Gothic40
QChar::Script_Grantha (since Qt 5.5)107
QChar::Script_Greek4
QChar::Script_Gujarati14
QChar::Script_GunjalaGondi (since Qt 5.15)143
QChar::Script_Gurmukhi13
QChar::Script_GurungKhema (since Qt 6.9)165
QChar::Script_Han37
QChar::Script_Hangul26
QChar::Script_HanifiRohingya (since Qt 5.15)144
QChar::Script_Hanunoo43
QChar::Script_Hatran (since Qt 5.6)128
QChar::Script_Hebrew7
QChar::Script_Hiragana34
QChar::Script_ImperialAramaic87
QChar::Script_InscriptionalPahlavi90
QChar::Script_InscriptionalParthian89
QChar::Script_Javanese85
QChar::Script_Kaithi92
QChar::Script_Kannada18
QChar::Script_Katakana35
QChar::Script_Kawi (since Qt 6.5)162
QChar::Script_KayahLi72
QChar::Script_Kharoshthi61
QChar::Script_KhitanSmallScript (since Qt 5.15)155
QChar::Script_Khmer32
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_Lao22
QChar::Script_Latin3
QChar::Script_Lepcha68
QChar::Script_Limbu47
QChar::Script_LinearA (since Qt 5.5)110
QChar::Script_LinearB49
QChar::Script_Lisu83
QChar::Script_Lycian74
QChar::Script_Lydian76
QChar::Script_Mahajani (since Qt 5.5)111
QChar::Script_Makasar (since Qt 5.15)145
QChar::Script_Malayalam19
QChar::Script_Mandaic95
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_MeeteiMayek86
QChar::Script_MendeKikakui (since Qt 5.5)113
QChar::Script_MeroiticCursive97
QChar::Script_MeroiticHieroglyphs98
QChar::Script_Miao99
QChar::Script_Modi (since Qt 5.5)114
QChar::Script_Mongolian33
QChar::Script_Mro (since Qt 5.5)115
QChar::Script_Multani (since Qt 5.6)129
QChar::Script_Myanmar24
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_NewTaiLue56
QChar::Script_Nko66
QChar::Script_Nushu (since Qt 5.11)139
QChar::Script_NyiakengPuachueHmong (since Qt 5.15)151
QChar::Script_Ogham30
QChar::Script_OlChiki69
QChar::Script_OlOnal (since Qt 6.9)167
QChar::Script_OldHungarian (since Qt 5.6)130
QChar::Script_OldItalic39
QChar::Script_OldNorthArabian (since Qt 5.5)116
QChar::Script_OldPermic (since Qt 5.5)120
QChar::Script_OldPersian60
QChar::Script_OldSogdian (since Qt 5.15)147
QChar::Script_OldSouthArabian88
QChar::Script_OldTurkic91
QChar::Script_OldUyghur (since Qt 6.3)158
QChar::Script_Oriya15
QChar::Script_Osage (since Qt 5.11)136
QChar::Script_Osmanya52
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_PhagsPa65
QChar::Script_Phoenician64
QChar::Script_PsalterPahlavi (since Qt 5.5)121
QChar::Script_Rejang73
QChar::Script_Runic31
QChar::Script_Samaritan82
QChar::Script_Saurashtra71
QChar::Script_Sharada100
QChar::Script_Shavian51
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_Sinhala20
QChar::Script_Sogdian (since Qt 5.15)148
QChar::Script_SoraSompeng101
QChar::Script_Soyombo (since Qt 5.11)140
QChar::Script_Sundanese67
QChar::Script_Sunuwar (since Qt 6.9)168
QChar::Script_SylotiNagri59
QChar::Script_Syriac9
QChar::Script_Tagalog42
QChar::Script_Tagbanwa45
QChar::Script_TaiLe48
QChar::Script_TaiTham78
QChar::Script_TaiViet79
QChar::Script_TaiYo (since Qt 6.11)172
QChar::Script_Takri102
QChar::Script_Tamil16
QChar::Script_Tangut (since Qt 5.11)137
QChar::Script_Tangsa (since Qt 6.3)159
QChar::Script_Telugu17
QChar::Script_Thaana10
QChar::Script_Thai21
QChar::Script_Tibetan23
QChar::Script_Tifinagh58
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_Ugaritic50
QChar::Script_Vai70
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_Yi38
QChar::Script_ZanabazarSquare (since Qt 5.11)141

Véase también script().

enum QChar::SpecialCharacter

ConstanteValorDescripción
QChar::Null0x0000A QChar con este valor isNull().
QChar::Tabulation0x0009Tabulación de caracteres.
QChar::LineFeed0x000a
QChar::FormFeed0x000c
QChar::CarriageReturn0x000d
QChar::Space0x0020
QChar::Nbsp0x00a0Espacio de no ruptura.
QChar::SoftHyphen0x00ad
QChar::ReplacementCharacter0xfffdCarácter que aparece cuando una fuente no tiene 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::ObjectReplacementCharacter0xfffcSe utiliza para representar un objeto, como una imagen, cuando no se pueden presentar tales objetos.
QChar::ByteOrderMark0xfeff
QChar::ByteOrderSwapped0xfffe
QChar::ParagraphSeparator0x2029
QChar::LineSeparator0x2028
QChar::VisualTabCharacter (since Qt 6.2)0x2192Se utiliza para representar una tabulación como una flecha horizontal.
QChar::LastValidCodePoint0x10ffff

enum QChar::UnicodeVersion

Especifica qué versión del estándar Unicode introdujo un determinado carácter.

ConstanteValorDescripción
QChar::Unicode_1_11Versión 1.1
QChar::Unicode_2_02Versión 2.0
QChar::Unicode_2_1_23Versión 2.1.2
QChar::Unicode_3_04Versión 3.0
QChar::Unicode_3_15Versión 3.1
QChar::Unicode_3_26Versión 3.2
QChar::Unicode_4_07Versión 4.0
QChar::Unicode_4_18Versión 4.1
QChar::Unicode_5_09Versión 5.0
QChar::Unicode_5_110Versión 5.1
QChar::Unicode_5_211Versión 5.2
QChar::Unicode_6_012Versión 6.0
QChar::Unicode_6_113Versión 6.1
QChar::Unicode_6_214Versión 6.2
QChar::Unicode_6_3 (since Qt 5.3)15Versión 6.3
QChar::Unicode_7_0 (since Qt 5.5)16Versión 7.0
QChar::Unicode_8_0 (since Qt 5.6)17Versión 8.0
QChar::Unicode_9_0 (since Qt 5.11)18Versión 9.0
QChar::Unicode_10_0 (since Qt 5.11)19Versión 10.0
QChar::Unicode_11_0 (since Qt 5.15)20Versión 11.0
QChar::Unicode_12_0 (since Qt 5.15)21Versión 12.0
QChar::Unicode_12_1 (since Qt 5.15)22Versión 12.1
QChar::Unicode_13_0 (since Qt 5.15)23Versión 13.0
QChar::Unicode_14_0 (since Qt 6.3)24Versión 14.0
QChar::Unicode_15_0 (since Qt 6.5)25Versión 15.0
QChar::Unicode_15_1 (since Qt 6.8)26Versión 15.1
QChar::Unicode_16_0 (since Qt 6.9)27Versión 16.0
QChar::Unicode_17_0 (since Qt 6.11)28Versión 17.0
QChar::Unicode_Unassigned0El 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 la función miembro

[constexpr noexcept] QChar::QChar()

Construye un QChar nulo ('\0').

Véase también isNull().

[constexpr noexcept] QChar::QChar(QChar::SpecialCharacter ch)

Construye un QChar para el valor de carácter predefinido ch.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[constexpr noexcept] QChar::QChar(QLatin1Char ch)

Construye un QChar correspondiente al carácter ASCII/Latin-1 ch.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[constexpr noexcept] QChar::QChar(char ch)

Construye un QChar correspondiente al carácter ASCII/Latin-1 ch.

Nota: Este constructor no está disponible cuando QT_NO_CAST_FROM_ASCII está definido.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

Véase también QT_NO_CAST_FROM_ASCII.

[constexpr noexcept] QChar::QChar(char16_t ch)

Construye un QChar correspondiente al carácter UTF-16 ch.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[default] QChar::QChar(char32_t code)

Construye un QChar para el carácter con punto de código Unicode code.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[explicit constexpr noexcept] QChar::QChar(int code)

Construye un QChar para el carácter con punto de código Unicode code.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[constexpr noexcept] QChar::QChar(short code)

Construye un QChar para el carácter con punto de código Unicode code.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[explicit constexpr noexcept] QChar::QChar(uchar ch)

Construye un 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 deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

Ver también QT_NO_CAST_FROM_ASCII y QT_RESTRICTED_CAST_FROM_ASCII.

[explicit constexpr noexcept] QChar::QChar(uint code)

Construye un QChar para el carácter con punto de código Unicode code.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[constexpr noexcept] QChar::QChar(ushort code)

Construye un QChar para el carácter con punto de código Unicode code.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[constexpr noexcept] QChar::QChar(wchar_t ch)

Construye un QChar correspondiente al carácter ancho ch.

Nota: Este constructor sólo está disponible en Windows.

Nota: Desde Qt 6.9, las conversiones implícitas están deshabilitadas para este constructor. Esto significa que sólo acepta el tipo de argumento del constructor y no todo lo que implícitamente se convierte a él. Una solución compatible con versiones anteriores es convertir explícitamente a uno de los tipos de argumento soportados por los constructores QChar.

[explicit constexpr noexcept] QChar::QChar(uchar cell, uchar row)

Construye un QChar para la celda Unicode cell en la fila row.

Véase 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 tomaba un argumento uint.

Se trata de 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 para el carácter tal y como se define en el estándar Unicode. Esto es útil principalmente como pista de posicionamiento para las marcas adjuntas a un carácter base.

El motor de renderizado de texto Qt utiliza esta información para posicionar correctamente las marcas no espaciadas alrededor de un carácter base.

[static noexcept] unsigned char QChar::combiningClass(char32_t ucs4)

Devuelve la clase de combinación para el carácter codificado en UCS-4 especificado por ucs4, tal como se define en el estándar Unicode.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

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

Devuelve la versión Unicode soportada más reciente.

QString QChar::decomposition() const

Descompone un carácter en sus partes constituyentes. Devuelve una cadena vacía si no existe descomposición.

[static] QString QChar::decomposition(char32_t ucs4)

Descompone el carácter codificado en UCS-4 especificado por ucs4 en sus partes constituyentes. Devuelve una cadena vacía si no existe descomposición.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de 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 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 descomposición.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de 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 tomaba un argumento uint.

Se trata de 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 tomaba un argumento uint.

Se trata de una función sobrecargada.

[static constexpr noexcept] QChar QChar::fromLatin1(char c)

Convierte el carácter Latin-1 c a su equivalente QChar. Esto es útil sobre todo para software no internacionalizado.

Una alternativa es utilizar QLatin1Char.

Véase también toLatin1() y unicode().

[static constexpr noexcept, since 6.0] QChar QChar::fromUcs2(char16_t c)

Construye un QChar a partir del 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 char16_t chars[2],
  • puede ser convertida implícitamente a QStringView, e
  • iterar sobre ella con un bucle for de rango C++11.

Si c requiere sustitutos, chars[0] contiene el sustituto alto y chars[1] el sustituto bajo, y QStringView tiene tamaño 2. En caso contrario, chars[0] contiene c y chars[1] es null, y QStringView tiene tamaño 1.

Esto permite utilizar fácilmente el resultado:

QString s;
s += QChar::fromUcs4(ch);
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 si la dirección del texto está invertida; en caso contrario devuelve false.

Un equivalente un poco más rápido 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 si se invierte la dirección del texto; en caso contrario devuelve false.

Un equivalente un poco más rápido de (QChar::mirroredChar(ucs4) != ucs4).

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

Véase también mirroredChar().

[static constexpr noexcept] char16_t QChar::highSurrogate(char32_t ucs4)

Devuelve la parte sustituta alta 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 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 tomaba un argumento uint.

Se trata de una función sobrecargada.

Véase también isNumber().

[constexpr noexcept] bool QChar::isHighSurrogate() const

Devuelve true si QChar es la parte alta de un sustituto UTF16 (por ejemplo, si su punto de código está en el rango [0xd800..0xdbff]); false en caso contrario.

[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 UTF16 (por ejemplo, si su punto de código está en el rango [0xd800..0xdbff]); false en caso contrario.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de 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 uint.

Se trata de 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 Letra_* o Número_*); 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 Letra_* o Número_*); en caso contrario devuelve false.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

[constexpr noexcept] bool QChar::isLowSurrogate() const

Devuelve true si QChar es la parte baja de un sustituto UTF16 (por ejemplo, si su punto de código está en el rango [0xdc00..0xdfff]); false en caso contrario.

[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 inferior de un sustituto UTF16 (por ejemplo, si su punto de código está en el rango [0xdc00..0xdfff]); false en caso contrario.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

[constexpr noexcept] bool QChar::isLower() const

Devuelve true si el carácter es una letra minúscula, por ejemplo category() es 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 tomaba un argumento uint.

Se trata de 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 tomaba un argumento uint.

Se trata de una función sobrecargada.

[constexpr noexcept] bool QChar::isNonCharacter() const

Devuelve true si QChar no es un carácter; false en caso contrario.

Unicode tiene un cierto número de puntos de código que se clasifican como "no caracteres": es decir, se pueden utilizar para fines internos en las aplicaciones, pero no se pueden utilizar para el intercambio de texto. Son las dos últimas entradas de cada Plano Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff], etc.), así como las entradas en el 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; false en caso contrario.

Unicode tiene un cierto número de puntos de código que se clasifican como "no caracteres": es decir, se pueden utilizar para fines internos en las aplicaciones, pero no se pueden utilizar para el intercambio de texto. Esas son las dos últimas entradas de cada Plano Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff], etc.) así como las entradas en el rango [0xfdd0..0xfdef].

Nota: Antes de Qt 6, esta función tomaba un argumento 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 sólo 0-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 sólo 0-9); en caso contrario devuelve false.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

Véase también isDigit().

[noexcept] bool QChar::isPrint() const

Devuelve true si el carácter es un carácter imprimible; en caso contrario devuelve false. Se trata de cualquier carácter que no sea de la categoría Other_*.

Tenga en cuenta que esto no da ninguna indicación de si el carácter está disponible en una fuente en particular.

[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 sea de la categoría Other_*.

Tenga en cuenta que esto no da ninguna indicación de si el carácter está disponible en una fuente en particular.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de 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 tomaba un argumento uint.

Se trata de 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 ciertos puntos de código de la categoría Other_Control ); en caso contrario devuelve false.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

[constexpr noexcept] bool QChar::isSurrogate() const

Devuelve true si QChar contiene un punto de código que está en la parte alta o baja del rango de sustitutos UTF-16 (por ejemplo, si su punto de código está en el rango [0xd800..0xdfff]); false en caso contrario.

[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 está en la parte alta o baja del rango de sustitutos UTF-16 (por ejemplo, si su punto de código está en el rango [0xd800..0xdfff]); false en caso contrario.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de 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 uint.

Se trata de una función sobrecargada.

[constexpr noexcept] bool QChar::isTitleCase() const

Devuelve true si el carácter es una letra mayúscula, por ejemplo category() es 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 mayúscula, por ejemplo category() es Letter_Titlecase.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de 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() es 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 uint.

Se trata de una función sobrecargada.

Véase también isLower(), toUpper(), y toLower().

[noexcept] QChar::JoiningType QChar::joiningType() const

Devuelve información sobre los atributos del tipo de unión del carácter (necesario para determinadas lenguas como el árabe o el siríaco).

[static noexcept] QChar::JoiningType QChar::joiningType(char32_t ucs4)

Devuelve información sobre los atributos del tipo de unión del carácter codificado en UCS-4 especificado por ucs4 (necesario para ciertos idiomas como el árabe o el siríaco).

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

[static constexpr noexcept] char16_t QChar::lowSurrogate(char32_t ucs4)

Devuelve la parte sustituta 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 tomaba un argumento uint y devolvía ushort.

[noexcept] QChar QChar::mirroredChar() const

Devuelve el carácter reflejado si este 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 reflejado si el carácter codificado en UCS-4 especificado por ucs4 es un carácter reflejado; en caso contrario devuelve el propio carácter.

Nota: Antes de Qt 6, esta función tomaba un argumento uint y devolvía uint.

Se trata de 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 UTF16 (por ejemplo, si su punto de código es mayor o igual que 0x10000); false en caso contrario.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

[constexpr noexcept] uchar QChar::row() const

Devuelve la fila (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 de escritura Unicode para este carácter.

[static noexcept] QChar::Script QChar::script(char32_t ucs4)

Devuelve el valor de la propiedad de escritura Unicode para el carácter especificado en su forma codificada UCS-4 como ucs4.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

[static constexpr noexcept] char32_t QChar::surrogateToUcs4(char16_t high, char16_t low)

Convierte un par de sustitutos UTF16 con los valores high y low dados a su punto de código codificado en UCS-4.

Nota: Antes de Qt 6, esta función tomaba argumentos de ushort y devolvía uint.

[static constexpr noexcept] char32_t QChar::surrogateToUcs4(QChar high, QChar low)

Convierte un par de sustitutos UTF16 (high, low) a 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 en mayúsculas y minúsculas del carácter. Para la mayoría de los caracteres Unicode es lo mismo que toLower().

[static noexcept] char32_t QChar::toCaseFolded(char32_t ucs4)

Devuelve el equivalente entre mayúsculas y minúsculas del carácter codificado en UCS-4 especificado por ucs4. Para la mayoría de los caracteres Unicode es lo mismo que toLower().

Nota: Antes de Qt 6, esta función tomaba un argumento uint y devolvía uint.

Se trata de una función sobrecargada.

[constexpr noexcept] char QChar::toLatin1() const

Devuelve el carácter Latin-1 equivalente a QChar, o 0. Esto es útil principalmente para software no internacionalizado.

Nota: No es posible distinguir un carácter no Latin-1 de un carácter Latin-1 0 (NUL). 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 de título; 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 uint y devolvía uint.

Se trata de una función sobrecargada.

[noexcept] QChar QChar::toTitleCase() const

Devuelve el equivalente del título si el carácter está en minúsculas o mayúsculas; en caso contrario devuelve el carácter en sí.

[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 está en minúsculas o mayúsculas; en caso contrario devuelve el propio carácter.

Nota: Antes de Qt 6, esta función tomaba un argumento uint y devolvía uint.

Se trata de 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 de título; en caso contrario devuelve el propio carácter.

Nota: Esta función también devuelve el carácter original en el raro caso de que la forma 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 raro caso de que la forma en mayúsculas del carácter requiera dos o más caracteres.

Nota: Antes de Qt 6, esta función tomaba un argumento uint y devolvía uint.

Se trata de 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 QChar.

[noexcept] QChar::UnicodeVersion QChar::unicodeVersion() const

Devuelve la versión Unicode que introdujo este carácter.

[static noexcept] QChar::UnicodeVersion QChar::unicodeVersion(char32_t ucs4)

Devuelve la versión Unicode que introdujo el carácter especificado en su forma codificada UCS-4 como ucs4.

Nota: Antes de Qt 6, esta función tomaba un argumento uint.

Se trata de una función sobrecargada.

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 char chr en el stream out.

Ver también Serializar tipos de datos 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 char del flujo in en char chr.

Ver también Serializar tipos de datos 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.