En esta página

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

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QChar

CategoríaTipos comparablesDescripción
strongQChar
strongchar16_t, QString, QStringView, QLatin1StringView y QUtf8StringView.
strongconst 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)
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:

ConstanteValorDescripción
QChar::Mark_NonSpacing0Nombre de clase Unicode Mn
QChar::Mark_SpacingCombining1Nombre de la clase Unicode Mn
QChar::Mark_Enclosing2Nombre de la 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 la 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_Open21Nombre de clase Unicode: 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 de enumeración define los atributos de descomposición de Unicode. Consulte el estándar Unicode 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 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.

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

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

ConstanteValorDescripción
QChar::Script_Unknown0Para puntos de código no asignados, de uso privado, que no son caracteres y sustitutos.
QChar::Script_Inherited1Para 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_Common2Para 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_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::Null0x0000Un « QChar » con este valor isNull().
QChar::Tabulation0x0009Tabulación de caracteres.
QChar::LineFeed0x000a 
QChar::FormFeed0x000c 
QChar::CarriageReturn0x000d 
QChar::Space0x0020 
QChar::Nbsp0x00a0Espacio no separable.
QChar::SoftHyphen0x00ad 
QChar::ReplacementCharacter0xfffdCará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::ObjectReplacementCharacter0xfffcSe utiliza para representar un objeto, como una imagen, cuando dichos objetos no se pueden mostrar.
QChar::ByteOrderMark0xfeff 
QChar::ByteOrderSwapped0xfffe 
QChar::ParagraphSeparator0x2029 
QChar::LineSeparator0x2028 
QChar::VisualTabCharacter (since Qt 6.2)0x2192Se utiliza para representar una tabulación mediante una flecha horizontal.
QChar::LastValidCodePoint0x10ffff 

enum QChar::UnicodeVersion

Especifica en qué versión del estándar Unicode se 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 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:

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