QChar Class
La classe QChar représente un caractère Unicode sur 16 bits. En savoir plus...
| En-tête : | #include <QChar> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
- Liste de tous les membres, y compris les membres hérités
- QChar fait partie des classes pour les données de type chaîne.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Comparaisons QChar
| Catégorie | Types comparables | Description |
|---|---|---|
| strong | QChar | |
| strong | char16_t, QString, QStringView, QLatin1StringView et QUtf8StringView. | |
| strong | const char *, QByteArray et QByteArrayView. | Le contenu du tableau d'octets est interprété au format UTF-8. |
Types publics
| 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 } |
Fonctions publiques
| 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 |
Membres publics statiques
| 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) |
Éléments non membres associés
| 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) |
Description détaillée
Dans Qt, les caractères Unicode sont des entités de 16 bits sans balisage ni structure. Cette classe représente une telle entité. Elle est légère, ce qui permet de l'utiliser partout. La plupart des compilateurs la traitent comme une entité de type « unsigned short ».
QChar fournit un ensemble complet de fonctions de test et de classification, permettant la conversion vers et depuis d’autres formats, la conversion d’Unicode composé en Unicode décomposé, ainsi que la comparaison et la conversion de casse si vous le lui demandez.
Les fonctions de classification incluent des fonctions similaires à celles de l’en-tête C++ standard <cctype> (anciennement <ctype.h>), mais elles opèrent sur l’ensemble complet des caractères Unicode, et non pas uniquement sur la plage ASCII. Elles renvoient toutes « true » si le caractère est d’un certain type ; dans le cas contraire, elles renvoient « false ». Ces fonctions de classification sont : isNull() (renvoie « true » si le caractère est «\0 »), isPrint() (vrai si le caractère est un caractère imprimable quelconque, y compris les espaces), isPunct() (tout type de ponctuation), isMark() (marque Unicode), isLetter() (une lettre), isNumber() (tout type de caractère numérique, pas seulement 0-9), isLetterOrNumber() et isDigit() (chiffres décimaux). Toutes ces fonctions sont des wrappers autour de category() qui renvoient la catégorie définie par Unicode pour chaque caractère. Certaines d’entre elles calculent également les propriétés dérivées (par exemple, isSpace() renvoie true si le caractère appartient à la catégorie Separator_* ou s’il s’agit d’un point de code exceptionnel de la catégorie Other_Control ).
QChar fournit également la fonction direction(), qui indique le sens d’écriture « naturel » de ce caractère. La fonction joiningType() indique comment le caractère se raccorde à ses voisins (ce qui est surtout nécessaire pour l’arabe ou le syriaque) et enfin la fonction hasMirrored(), qui indique si le caractère doit être inversé lorsqu’il est imprimé dans son sens d’écriture « non naturel ».
Les caractères Unicode composés (tels que ring) peuvent être convertis en Unicode décomposé (« a » suivi d’un « anneau au-dessus ») à l’aide de decomposition().
En Unicode, la comparaison n’est pas nécessairement possible et la conversion de casse est, au mieux, très difficile. L’Unicode, qui couvre le monde « entier », englobe également la plupart des problèmes de casse et de tri rencontrés à l’échelle mondiale. Les opérateurs ==() et ses dérivés effectuent une comparaison basée uniquement sur la valeur numérique Unicode (point de code) des caractères, tandis que les fonctions toUpper() et toLower() effectuent des changements de casse lorsque le caractère possède un équivalent majuscule/minuscule bien défini. Pour les comparaisons dépendantes des paramètres régionaux, utilisez QString::localeAwareCompare().
Les fonctions de conversion comprennent unicode() (vers un scalaire), toLatin1() (vers un scalaire, mais convertit tous les caractères non Latin-1 en 0), row() (renvoie la ligne Unicode), cell() (renvoie la cellule Unicode), digitValue() (renvoie la valeur entière de n’importe lequel des nombreux caractères numériques), ainsi qu’une multitude de constructeurs.
QChar fournit des constructeurs et des opérateurs de transtypage qui facilitent la conversion vers et depuis les chaînes de caractères traditionnelles de 8 bits ( char). Si vous avez défini QT_NO_CAST_FROM_ASCII et QT_NO_CAST_TO_ASCII, comme expliqué dans la documentation QString, vous devrez appeler explicitement fromLatin1(), ou utiliser QLatin1Char, pour construire un QChar à partir d’un char de 8 bits, et vous devrez appeler toLatin1() pour récupérer la valeur de 8 bits.
À partir de Qt 6.0, la plupart des constructeurs QChar sont de type explicit. Cette mesure vise à éviter les erreurs dangereuses liées à un mélange accidentel de types entiers et de chaînes de caractères.
Pour plus d’informations, consultez la section « À propos de la base de données des caractères Unicode ».
Voir également Unicode, QString et QLatin1Char.
Documentation sur les types de membres
enum QChar::Category
Cette énumération correspond aux catégories de caractères Unicode.
Les caractères suivants sont normatifs dans Unicode :
| Constante | Valeur | Description |
|---|---|---|
QChar::Mark_NonSpacing | 0 | Nom de classe Unicode Mn |
QChar::Mark_SpacingCombining | 1 | Nom de la classe Unicode Mn |
QChar::Mark_Enclosing | 2 | Nom de classe Unicode Me |
QChar::Number_DecimalDigit | 3 | Nom de classe Unicode Nd |
QChar::Number_Letter | 4 | Nom de classe Unicode Nl |
QChar::Number_Other | 5 | Nom de classe Unicode No |
QChar::Separator_Space | 6 | Nom de classe Unicode Zs |
QChar::Separator_Line | 7 | Nom de classe Unicode Zl |
QChar::Separator_Paragraph | 8 | Nom de classe Unicode Zp |
QChar::Other_Control | 9 | Nom de classe Unicode Cc |
QChar::Other_Format | 10 | Nom de classe Unicode Cf |
QChar::Other_Surrogate | 11 | Nom de classe Unicode Cs |
QChar::Other_PrivateUse | 12 | Nom de classe Unicode Co |
QChar::Other_NotAssigned | 13 | Nom de classe Unicode Cn |
Les catégories suivantes sont informatives dans Unicode :
| Constante | Valeur | Description |
|---|---|---|
QChar::Letter_Uppercase | 14 | Nom de classe Unicode Lu |
QChar::Letter_Lowercase | 15 | Nom de classe Unicode Ll |
QChar::Letter_Titlecase | 16 | Nom de classe Unicode Lt |
QChar::Letter_Modifier | 17 | Nom de classe Unicode Lm |
QChar::Letter_Other | 18 | Nom de classe Unicode Lo |
QChar::Punctuation_Connector | 19 | Nom de classe Unicode Pc |
QChar::Punctuation_Dash | 20 | Nom de classe Unicode Pd |
QChar::Punctuation_Open | 21 | Nom de classe Unicode Ps |
QChar::Punctuation_Close | 22 | Nom de classe Unicode Pe |
QChar::Punctuation_InitialQuote | 23 | Nom de classe Unicode Pi |
QChar::Punctuation_FinalQuote | 24 | Nom de classe Unicode Pf |
QChar::Punctuation_Other | 25 | Nom de classe Unicode Po |
QChar::Symbol_Math | 26 | Nom de classe Unicode Sm |
QChar::Symbol_Currency | 27 | Nom de classe Unicode Sc |
QChar::Symbol_Modifier | 28 | Nom de classe Unicode Sk |
QChar::Symbol_Other | 29 | Nom de classe Unicode So |
Voir aussi category().
enum QChar::Decomposition
Ce type d'énumération définit les attributs de décomposition Unicode. Reportez-vous à la norme Unicode pour obtenir une description des valeurs.
| Constante | Valeur |
|---|---|
QChar::NoDecomposition | 0 |
QChar::Canonical | 1 |
QChar::Circle | 8 |
QChar::Compat | 16 |
QChar::Final | 6 |
QChar::Font | 2 |
QChar::Fraction | 17 |
QChar::Initial | 4 |
QChar::Isolated | 7 |
QChar::Medial | 5 |
QChar::Narrow | 13 |
QChar::NoBreak | 3 |
QChar::Small | 14 |
QChar::Square | 15 |
QChar::Sub | 10 |
QChar::Super | 9 |
QChar::Vertical | 11 |
QChar::Wide | 12 |
Voir également la fonction ` decomposition()`.
enum QChar::Direction
Ce type d'énumération définit les attributs de direction Unicode. Reportez-vous à la norme Unicode pour obtenir une description des valeurs.
Afin de respecter les conventions de nommage C/C++, le préfixe « Dir » est ajouté aux codes utilisés dans la norme Unicode.
| Constante | Valeur |
|---|---|
QChar::DirAL | 13 |
QChar::DirAN | 5 |
QChar::DirB | 7 |
QChar::DirBN | 18 |
QChar::DirCS | 6 |
QChar::DirEN | 2 |
QChar::DirES | 3 |
QChar::DirET | 4 |
QChar::DirFSI (since Qt 5.3) | 21 |
QChar::DirL | 0 |
QChar::DirLRE | 11 |
QChar::DirLRI (since Qt 5.3) | 19 |
QChar::DirLRO | 12 |
QChar::DirNSM | 17 |
QChar::DirON | 10 |
QChar::DirPDF | 16 |
QChar::DirPDI (since Qt 5.3) | 22 |
QChar::DirR | 1 |
QChar::DirRLE | 14 |
QChar::DirRLI (since Qt 5.3) | 20 |
QChar::DirRLO | 15 |
QChar::DirS | 8 |
QChar::DirWS | 9 |
Voir également direction().
enum QChar::JoiningType
depuis la version 5.3
Ce type d'énumération définit les attributs de type de jonction Unicode. Reportez-vous à la norme Unicode pour une description des valeurs.
Afin de respecter les conventions de nommage C/C++, le préfixe « Joining_ » est ajouté aux codes utilisés dans la norme Unicode.
| Constante | Valeur |
|---|---|
QChar::Joining_None | 0 |
QChar::Joining_Causing | 1 |
QChar::Joining_Dual | 2 |
QChar::Joining_Right | 3 |
QChar::Joining_Left | 4 |
QChar::Joining_Transparent | 5 |
Voir également joiningType().
enum QChar::Script
Ce type d'énumération définit les valeurs de la propriété « script » d'Unicode.
Pour plus de détails sur les valeurs de la propriété « script » d'Unicode, consultez l'annexe n° 24 de la norme Unicode.
Afin de respecter les conventions de nommage C/C++, le préfixe « Script_ » est ajouté aux codes utilisés dans la norme Unicode.
| Constante | Valeur | Description |
|---|---|---|
QChar::Script_Unknown | 0 | Pour les points de code non attribués, à usage privé, non alphabétiques et de substitution. |
QChar::Script_Inherited | 1 | Pour les caractères pouvant être utilisés avec plusieurs scripts et qui héritent de leur script des caractères précédents. Il s’agit notamment des marques non espacées, des marques d’encadrement et des caractères de jonction/non-jonction de largeur nulle. |
QChar::Script_Common | 2 | Pour les caractères pouvant être utilisés avec plusieurs scripts et qui n’héritent pas de leur script des caractères précédents. |
QChar::Script_Adlam (since Qt 5.11) | 132 | |
QChar::Script_Ahom (since Qt 5.6) | 126 | |
QChar::Script_AnatolianHieroglyphs (since Qt 5.6) | 127 | |
QChar::Script_Arabic | 8 | |
QChar::Script_Armenian | 6 | |
QChar::Script_Avestan | 80 | |
QChar::Script_Balinese | 62 | |
QChar::Script_Bamum | 84 | |
QChar::Script_BassaVah (since Qt 5.5) | 104 | |
QChar::Script_Batak | 93 | |
QChar::Script_Bengali | 12 | |
QChar::Script_BeriaErfe (since Qt 6.11) | 174 | |
QChar::Script_Bhaiksuki (since Qt 5.11) | 133 | |
QChar::Script_Bopomofo | 36 | |
QChar::Script_Brahmi | 94 | |
QChar::Script_Braille | 54 | |
QChar::Script_Buginese | 55 | |
QChar::Script_Buhid | 44 | |
QChar::Script_CanadianAboriginal | 29 | |
QChar::Script_Carian | 75 | |
QChar::Script_CaucasianAlbanian (since Qt 5.5) | 103 | |
QChar::Script_Chakma | 96 | |
QChar::Script_Cham | 77 | |
QChar::Script_Cherokee | 28 | |
QChar::Script_Chorasmian (since Qt 5.15) | 153 | |
QChar::Script_Coptic | 46 | |
QChar::Script_Cuneiform | 63 | |
QChar::Script_Cypriot | 53 | |
QChar::Script_CyproMinoan (since Qt 6.3) | 157 | |
QChar::Script_Cyrillic | 5 | |
QChar::Script_Deseret | 41 | |
QChar::Script_Devanagari | 11 | |
QChar::Script_DivesAkuru (since Qt 5.15) | 154 | |
QChar::Script_Dogra (since Qt 5.15) | 142 | |
QChar::Script_Duployan (since Qt 5.5) | 105 | |
QChar::Script_EgyptianHieroglyphs | 81 | |
QChar::Script_Elbasan (since Qt 5.5) | 106 | |
QChar::Script_Elymaic (since Qt 5.15) | 149 | |
QChar::Script_Ethiopic | 27 | |
QChar::Script_Garay (since Qt 6.9) | 164 | |
QChar::Script_Georgian | 25 | |
QChar::Script_Glagolitic | 57 | |
QChar::Script_Gothic | 40 | |
QChar::Script_Grantha (since Qt 5.5) | 107 | |
QChar::Script_Greek | 4 | |
QChar::Script_Gujarati | 14 | |
QChar::Script_GunjalaGondi (since Qt 5.15) | 143 | |
QChar::Script_Gurmukhi | 13 | |
QChar::Script_GurungKhema (since Qt 6.9) | 165 | |
QChar::Script_Han | 37 | |
QChar::Script_Hangul | 26 | |
QChar::Script_HanifiRohingya (since Qt 5.15) | 144 | |
QChar::Script_Hanunoo | 43 | |
QChar::Script_Hatran (since Qt 5.6) | 128 | |
QChar::Script_Hebrew | 7 | |
QChar::Script_Hiragana | 34 | |
QChar::Script_ImperialAramaic | 87 | |
QChar::Script_InscriptionalPahlavi | 90 | |
QChar::Script_InscriptionalParthian | 89 | |
QChar::Script_Javanese | 85 | |
QChar::Script_Kaithi | 92 | |
QChar::Script_Kannada | 18 | |
QChar::Script_Katakana | 35 | |
QChar::Script_Kawi (since Qt 6.5) | 162 | |
QChar::Script_KayahLi | 72 | |
QChar::Script_Kharoshthi | 61 | |
QChar::Script_KhitanSmallScript (since Qt 5.15) | 155 | |
QChar::Script_Khmer | 32 | |
QChar::Script_Khojki (since Qt 5.5) | 109 | |
QChar::Script_Khudawadi (since Qt 5.5) | 123 | |
QChar::Script_KiratRai (since Qt 6.9) | 166 | |
QChar::Script_Lao | 22 | |
QChar::Script_Latin | 3 | |
QChar::Script_Lepcha | 68 | |
QChar::Script_Limbu | 47 | |
QChar::Script_LinearA (since Qt 5.5) | 110 | |
QChar::Script_LinearB | 49 | |
QChar::Script_Lisu | 83 | |
QChar::Script_Lycian | 74 | |
QChar::Script_Lydian | 76 | |
QChar::Script_Mahajani (since Qt 5.5) | 111 | |
QChar::Script_Makasar (since Qt 5.15) | 145 | |
QChar::Script_Malayalam | 19 | |
QChar::Script_Mandaic | 95 | |
QChar::Script_Manichaean (since Qt 5.5) | 112 | |
QChar::Script_Marchen (since Qt 5.11) | 134 | |
QChar::Script_MasaramGondi (since Qt 5.11) | 138 | |
QChar::Script_Medefaidrin (since Qt 5.15) | 146 | |
QChar::Script_MeeteiMayek | 86 | |
QChar::Script_MendeKikakui (since Qt 5.5) | 113 | |
QChar::Script_MeroiticCursive | 97 | |
QChar::Script_MeroiticHieroglyphs | 98 | |
QChar::Script_Miao | 99 | |
QChar::Script_Modi (since Qt 5.5) | 114 | |
QChar::Script_Mongolian | 33 | |
QChar::Script_Mro (since Qt 5.5) | 115 | |
QChar::Script_Multani (since Qt 5.6) | 129 | |
QChar::Script_Myanmar | 24 | |
QChar::Script_Nabataean (since Qt 5.5) | 117 | |
QChar::Script_NagMundari (since Qt 6.3) | 163 | |
QChar::Script_Nandinagari (since Qt 5.15) | 150 | |
QChar::Script_Newa (since Qt 5.11) | 135 | |
QChar::Script_NewTaiLue | 56 | |
QChar::Script_Nko | 66 | |
QChar::Script_Nushu (since Qt 5.11) | 139 | |
QChar::Script_NyiakengPuachueHmong (since Qt 5.15) | 151 | |
QChar::Script_Ogham | 30 | |
QChar::Script_OlChiki | 69 | |
QChar::Script_OlOnal (since Qt 6.9) | 167 | |
QChar::Script_OldHungarian (since Qt 5.6) | 130 | |
QChar::Script_OldItalic | 39 | |
QChar::Script_OldNorthArabian (since Qt 5.5) | 116 | |
QChar::Script_OldPermic (since Qt 5.5) | 120 | |
QChar::Script_OldPersian | 60 | |
QChar::Script_OldSogdian (since Qt 5.15) | 147 | |
QChar::Script_OldSouthArabian | 88 | |
QChar::Script_OldTurkic | 91 | |
QChar::Script_OldUyghur (since Qt 6.3) | 158 | |
QChar::Script_Oriya | 15 | |
QChar::Script_Osage (since Qt 5.11) | 136 | |
QChar::Script_Osmanya | 52 | |
QChar::Script_PahawhHmong (since Qt 5.5) | 108 | |
QChar::Script_Palmyrene (since Qt 5.5) | 118 | |
QChar::Script_PauCinHau (since Qt 5.5) | 119 | |
QChar::Script_PhagsPa | 65 | |
QChar::Script_Phoenician | 64 | |
QChar::Script_PsalterPahlavi (since Qt 5.5) | 121 | |
QChar::Script_Rejang | 73 | |
QChar::Script_Runic | 31 | |
QChar::Script_Samaritan | 82 | |
QChar::Script_Saurashtra | 71 | |
QChar::Script_Sharada | 100 | |
QChar::Script_Shavian | 51 | |
QChar::Script_Siddham (since Qt 5.5) | 122 | |
QChar::Script_Sidetic (since Qt 6.11) | 171 | |
QChar::Script_SignWriting (since Qt 5.6) | 131 | |
QChar::Script_Sinhala | 20 | |
QChar::Script_Sogdian (since Qt 5.15) | 148 | |
QChar::Script_SoraSompeng | 101 | |
QChar::Script_Soyombo (since Qt 5.11) | 140 | |
QChar::Script_Sundanese | 67 | |
QChar::Script_Sunuwar (since Qt 6.9) | 168 | |
QChar::Script_SylotiNagri | 59 | |
QChar::Script_Syriac | 9 | |
QChar::Script_Tagalog | 42 | |
QChar::Script_Tagbanwa | 45 | |
QChar::Script_TaiLe | 48 | |
QChar::Script_TaiTham | 78 | |
QChar::Script_TaiViet | 79 | |
QChar::Script_TaiYo (since Qt 6.11) | 172 | |
QChar::Script_Takri | 102 | |
QChar::Script_Tamil | 16 | |
QChar::Script_Tangut (since Qt 5.11) | 137 | |
QChar::Script_Tangsa (since Qt 6.3) | 159 | |
QChar::Script_Telugu | 17 | |
QChar::Script_Thaana | 10 | |
QChar::Script_Thai | 21 | |
QChar::Script_Tibetan | 23 | |
QChar::Script_Tifinagh | 58 | |
QChar::Script_Tirhuta (since Qt 5.5) | 124 | |
QChar::Script_Todhri (since Qt 6.9) | 169 | |
QChar::Script_TolongSiki (since Qt 6.11) | 173 | |
QChar::Script_Toto (since Qt 6.3) | 160 | |
QChar::Script_TuluTigalari (since Qt 6.9) | 170 | |
QChar::Script_Ugaritic | 50 | |
QChar::Script_Vai | 70 | |
QChar::Script_Vithkuqi (since Qt 6.3) | 161 | |
QChar::Script_Wancho (since Qt 5.15) | 152 | |
QChar::Script_WarangCiti (since Qt 5.5) | 125 | |
QChar::Script_Yezidi (since Qt 5.15) | 156 | |
QChar::Script_Yi | 38 | |
QChar::Script_ZanabazarSquare (since Qt 5.11) | 141 |
Voir également script().
enum QChar::SpecialCharacter
| Constante | Valeur | Description |
|---|---|---|
QChar::Null | 0x0000 | Une QChar e avec cette valeur isNull(). |
QChar::Tabulation | 0x0009 | Tabulation de caractères. |
QChar::LineFeed | 0x000a | |
QChar::FormFeed | 0x000c | |
QChar::CarriageReturn | 0x000d | |
QChar::Space | 0x0020 | |
QChar::Nbsp | 0x00a0 | Espace insécable. |
QChar::SoftHyphen | 0x00ad | |
QChar::ReplacementCharacter | 0xfffd | Caractère affiché lorsqu’une police ne dispose pas de glyphe correspondant à un code spécifique. On utilise souvent un point d’interrogation spécial. Les codecs utilisent ce code lorsque les données d’entrée ne peuvent pas être représentées en Unicode. |
QChar::ObjectReplacementCharacter | 0xfffc | Utilisé pour représenter un objet, tel qu'une image, lorsque ce type d'objet ne peut pas être affiché. |
QChar::ByteOrderMark | 0xfeff | |
QChar::ByteOrderSwapped | 0xfffe | |
QChar::ParagraphSeparator | 0x2029 | |
QChar::LineSeparator | 0x2028 | |
QChar::VisualTabCharacter (since Qt 6.2) | 0x2192 | Utilisé pour représenter un tabulation sous la forme d’une flèche horizontale. |
QChar::LastValidCodePoint | 0x10ffff |
enum QChar::UnicodeVersion
Indique dans quelle version de la norme Unicode un caractère donné a été introduit.
| Constante | Valeur | Description |
|---|---|---|
QChar::Unicode_1_1 | 1 | Version 1.1 |
QChar::Unicode_2_0 | 2 | Version 2.0 |
QChar::Unicode_2_1_2 | 3 | Version 2.1.2 |
QChar::Unicode_3_0 | 4 | Version 3.0 |
QChar::Unicode_3_1 | 5 | Version 3.1 |
QChar::Unicode_3_2 | 6 | Version 3.2 |
QChar::Unicode_4_0 | 7 | Version 4.0 |
QChar::Unicode_4_1 | 8 | Version 4.1 |
QChar::Unicode_5_0 | 9 | Version 5.0 |
QChar::Unicode_5_1 | 10 | Version 5.1 |
QChar::Unicode_5_2 | 11 | Version 5.2 |
QChar::Unicode_6_0 | 12 | Version 6.0 |
QChar::Unicode_6_1 | 13 | Version 6.1 |
QChar::Unicode_6_2 | 14 | Version 6.2 |
QChar::Unicode_6_3 (since Qt 5.3) | 15 | Version 6.3 |
QChar::Unicode_7_0 (since Qt 5.5) | 16 | Version 7.0 |
QChar::Unicode_8_0 (since Qt 5.6) | 17 | Version 8.0 |
QChar::Unicode_9_0 (since Qt 5.11) | 18 | Version 9.0 |
QChar::Unicode_10_0 (since Qt 5.11) | 19 | Version 10.0 |
QChar::Unicode_11_0 (since Qt 5.15) | 20 | Version 11.0 |
QChar::Unicode_12_0 (since Qt 5.15) | 21 | Version 12.0 |
QChar::Unicode_12_1 (since Qt 5.15) | 22 | Version 12.1 |
QChar::Unicode_13_0 (since Qt 5.15) | 23 | Version 13.0 |
QChar::Unicode_14_0 (since Qt 6.3) | 24 | Version 14.0 |
QChar::Unicode_15_0 (since Qt 6.5) | 25 | Version 15.0 |
QChar::Unicode_15_1 (since Qt 6.8) | 26 | Version 15.1 |
QChar::Unicode_16_0 (since Qt 6.9) | 27 | Version 16.0 |
QChar::Unicode_17_0 (since Qt 6.11) | 28 | Version 17.0 |
QChar::Unicode_Unassigned | 0 | Cette valeur n'est attribuée à aucun caractère dans la version 8.0 d'Unicode. |
Voir également unicodeVersion() et currentUnicodeVersion().
Documentation sur les fonctions membres
[constexpr noexcept] QChar::QChar()
Crée un objet QChar nul («\0 »).
Voir aussi isNull().
[constexpr noexcept] QChar::QChar(QChar::SpecialCharacter ch)
Construit un objet `QChar` correspondant à la valeur de caractère prédéfinie ` ch`.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
[constexpr noexcept] QChar::QChar(QLatin1Char ch)
Construit un objet `QChar` correspondant au caractère ASCII/Latin-1 ch.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
[constexpr noexcept] QChar::QChar(char ch)
Construit un objet `QChar` correspondant au caractère ASCII/Latin-1 ch.
Remarque : ce constructeur n’est pas disponible lorsque QT_NO_CAST_FROM_ASCII est défini.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
Voir aussi QT_NO_CAST_FROM_ASCII.
[constexpr noexcept] QChar::QChar(char16_t ch)
Construit un objet `QChar` correspondant au caractère UTF-16 ch.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’argument pris en charge par les constructeurs de QChar.
[implicit] QChar::QChar(char32_t code)
Crée un objet `QChar` correspondant au caractère dont le point de code Unicode est code.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution compatible avec les versions antérieures consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs QChar.
[explicit constexpr noexcept] QChar::QChar(int code)
Crée un objet `QChar` correspondant au caractère dont le point de code Unicode est code.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution compatible avec les versions antérieures consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
[constexpr noexcept] QChar::QChar(short code)
Crée un objet `QChar` correspondant au caractère dont le point de code Unicode est ` code`.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs QChar.
[explicit constexpr noexcept] QChar::QChar(uchar ch)
Crée un objet `QChar` correspondant au caractère ASCII/Latin-1 ch.
Remarque : ce constructeur n'est pas disponible lorsque QT_NO_CAST_FROM_ASCII ou QT_RESTRICTED_CAST_FROM_ASCII est défini.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
Voir également QT_NO_CAST_FROM_ASCII et QT_RESTRICTED_CAST_FROM_ASCII.
[explicit constexpr noexcept] QChar::QChar(uint code)
Crée un objet `QChar` correspondant au caractère dont le point de code Unicode est code.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type de l’argument du constructeur et non tout ce qui peut y être converti implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
[constexpr noexcept] QChar::QChar(ushort code)
Crée un objet `QChar` correspondant au caractère dont le point de code Unicode est ` code`.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs QChar.
[constexpr noexcept] QChar::QChar(wchar_t ch)
Crée un objet `QChar` correspondant au caractère étendu ch.
Remarque : ce constructeur n'est disponible que sous Windows.
Remarque : depuis Qt 6.9, les conversions implicites sont désactivées pour ce constructeur. Cela signifie qu’il n’accepte que le type d’argument du constructeur et non tout ce qui s’y convertit implicitement. Une solution rétrocompatible consiste à effectuer explicitement un transtypage vers l’un des types d’arguments pris en charge par les constructeurs de QChar.
[explicit constexpr noexcept] QChar::QChar(uchar cell, uchar row)
Crée un objet QChar à partir de la cellule Unicode cell située à la ligne row.
Voir également cell() et row().
[noexcept] QChar::Category QChar::category() const
Renvoie la catégorie du personnage.
[static noexcept] QChar::Category QChar::category(char32_t ucs4)
Renvoie la catégorie du caractère encodé en UCS-4 spécifié par ` ucs4`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] uchar QChar::cell() const
Renvoie la cellule (octet de poids faible) du caractère Unicode.
Voir aussi ` row()`.
[noexcept] unsigned char QChar::combiningClass() const
Renvoie la classe de combinaison du caractère telle que définie dans la norme Unicode. Cette information est principalement utile comme indication de positionnement pour les marques associées à un caractère de base.
Le moteur de rendu de texte de Qt utilise ces informations pour positionner correctement les marques non espacées autour d'un caractère de base.
[static noexcept] unsigned char QChar::combiningClass(char32_t ucs4)
Renvoie la classe de combinaison du caractère encodé en UCS-4 spécifié par ucs4, telle que définie dans la norme Unicode.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[static noexcept] QChar::UnicodeVersion QChar::currentUnicodeVersion()
Renvoie la version Unicode la plus récente prise en charge.
QString QChar::decomposition() const
Décompose un caractère en ses éléments constitutifs. Renvoie une chaîne vide s'il n'existe aucune décomposition.
[static] QString QChar::decomposition(char32_t ucs4)
Décompose le caractère encodé en UCS-4 spécifié par ` ucs4 ` en ses éléments constitutifs. Renvoie une chaîne vide si aucune décomposition n'est possible.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[noexcept] QChar::Decomposition QChar::decompositionTag() const
Renvoie la balise définissant la composition du caractère. Renvoie « QChar::NoDecomposition » s'il n'existe aucune décomposition.
[static noexcept] QChar::Decomposition QChar::decompositionTag(char32_t ucs4)
Renvoie la balise définissant la décomposition du caractère encodé en UCS-4 spécifié par ucs4. Renvoie QChar::NoDecomposition si aucune décomposition n'existe.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[noexcept] int QChar::digitValue() const
Renvoie la valeur numérique du chiffre, ou -1 si le caractère n'est pas un chiffre.
[static noexcept] int QChar::digitValue(char32_t ucs4)
Renvoie la valeur numérique du chiffre spécifié par le caractère encodé en UCS-4, ucs4, ou -1 si le caractère n'est pas un chiffre.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[noexcept] QChar::Direction QChar::direction() const
Renvoie la direction du personnage.
[static noexcept] QChar::Direction QChar::direction(char32_t ucs4)
Renvoie la direction du caractère encodé en UCS-4 spécifié par ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[static constexpr noexcept] QChar QChar::fromLatin1(char c)
Convertit le caractère Latin-1 « c » en son équivalent « QChar ». Cette fonction est principalement utile pour les logiciels non internationalisés.
Une alternative consiste à utiliser ` QLatin1Char`.
Voir également toLatin1() et unicode().
[static constexpr noexcept, since 6.0] QChar QChar::fromUcs2(char16_t c)
Crée un objet ` QChar ` à partir d'un ` c` de caractères UTF-16.
Cette fonction a été introduite dans Qt 6.0.
Voir aussi ` fromUcs4()`.
[static constexpr noexcept, since 6.0] auto QChar::fromUcs4(char32_t c)
Renvoie une structure anonyme qui
- contient un tableau de type «
char16_t chars[2]», - peut être implicitement converti en un ` QStringView`, et
- peut être parcouru à l’aide d’une boucle « for » avec plage de C++11.
Si ` c ` nécessite des caractères de substitution, ` chars[0] ` contient le caractère de substitution haut et ` chars[1] ` le caractère de substitution bas, et la QStringView a une taille de 2. Sinon, ` chars[0] ` contient ` c ` et ` chars[1] ` est ` null`, et la QStringView a une taille de 1.
Cela permet d’utiliser facilement le résultat :
for (char16_t c16 : QChar::fromUcs4(ch))
use(c16);Cette fonction a été introduite dans Qt 6.0.
Voir également fromUcs2() et requiresSurrogates().
[noexcept] bool QChar::hasMirrored() const
Renvoie « true » si le caractère doit être inversé lorsque le sens d'écriture est inversé ; sinon, renvoie « false ».
Équivalent légèrement plus rapide de (ch.mirroredChar() != ch).
Voir également mirroredChar().
[static noexcept] bool QChar::hasMirrored(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` doit être inversé lorsque le sens d'écriture est inversé ; sinon, renvoie ` false`.
Équivalent légèrement plus rapide de (QChar::mirroredChar(ucs4) != ucs4).
Remarque : avant Qt 6, cette fonction prenait un argument de type uint.
Il s'agit d'une fonction surchargée.
Voir aussi ` mirroredChar()`.
[static constexpr noexcept] char16_t QChar::highSurrogate(char32_t ucs4)
Renvoie la partie « high » d'un point de code encodé en UCS-4. Le résultat renvoyé n'est pas défini si ucs4 est inférieur à 0x10000.
Remarque : avant Qt 6, cette fonction prenait un argument « uint » et renvoyait « ushort ».
[constexpr noexcept] bool QChar::isDigit() const
Renvoie « true » si le caractère est un chiffre décimal (Number_DecimalDigit) ; sinon, renvoie « false ».
Voir également isNumber().
[static constexpr noexcept] bool QChar::isDigit(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` est un chiffre décimal (Number_DecimalDigit) ; sinon, renvoie ` false`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
Voir également isNumber().
[constexpr noexcept] bool QChar::isHighSurrogate() const
Renvoie « true » si l'QChar e correspond à la partie haute d'un substitut UTF-16 (par exemple, si son point de code se situe dans la plage [0xd800..0xdbff]) ; sinon, renvoie « false ».
[static constexpr noexcept] bool QChar::isHighSurrogate(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » correspond à la partie haute d'un caractère de substitution UTF-16 (par exemple, si son point de code se situe dans l'intervalle [0xd800..0xdbff]) ; « false » dans le cas contraire.
Remarque : Avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isLetter() const
Renvoie « true » si le caractère est une lettre (catégories Letter_*) ; sinon, renvoie « false ».
[static constexpr noexcept] bool QChar::isLetter(char32_t ucs4)
Renvoie ` true ` si le caractère codé en UCS-4 spécifié par ` ucs4 ` est une lettre (catégories `Letter_*`) ; sinon, renvoie ` false`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isLetterOrNumber() const
Renvoie « true » si le caractère est une lettre ou un chiffre (catégories « Letter_* » ou « Number_* ») ; sinon, renvoie « false ».
[static constexpr noexcept] bool QChar::isLetterOrNumber(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » est une lettre ou un chiffre (catégories « Letter_* » ou « Number_* ») ; sinon, renvoie « false ».
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isLowSurrogate() const
Renvoie ` true ` si l'QChar e correspond à la partie basse d'un substitut UTF-16 (par exemple, si son point de code se situe dans l'intervalle [0xdc00..0xdfff]) ; `false` dans le cas contraire.
[static constexpr noexcept] bool QChar::isLowSurrogate(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » correspond à la partie basse d'un caractère de substitution UTF-16 (par exemple, si son point de code se situe dans l'intervalle [0xdc00..0xdfff]) ; sinon, renvoie « false ».
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isLower() const
Renvoie « true » si le caractère est une lettre minuscule ; par exemple, « category() » donne « Letter_Lowercase ».
Voir également isUpper(), toLower() et toUpper().
[static constexpr noexcept] bool QChar::isLower(char32_t ucs4)
Renvoie « true » si le caractère codé en UCS-4 spécifié par « ucs4 » est une lettre minuscule ; par exemple, « category() » renvoie « Letter_Lowercase ».
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s’agit d’une fonction surchargée.
Voir également isUpper(), toLower() et toUpper().
[noexcept] bool QChar::isMark() const
Renvoie « true » si le caractère est une marque (catégories Mark_*) ; sinon, renvoie « false ».
Voir QChar::Category pour plus d'informations sur les marques.
[static noexcept] bool QChar::isMark(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` est une marque (catégories `Mark_*`) ; sinon, renvoie ` false`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s’agit d’une fonction surchargée.
[constexpr noexcept] bool QChar::isNonCharacter() const
Renvoie « true » si l'QChar e est un élément non alphabétique ; « false » dans le cas contraire.
Unicode comporte un certain nombre de points de code classés comme « non-caractères » : cela signifie qu’ils peuvent être utilisés à des fins internes dans les applications, mais ne peuvent pas servir à l’échange de texte. Il s’agit des deux dernières entrées de chaque plan Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff], etc.) ainsi que des entrées comprises dans la plage [0xfdd0..0xfdef].
[static constexpr noexcept] bool QChar::isNonCharacter(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » est un élément non-caractère ; renvoie « false » dans le cas contraire.
Unicode comporte un certain nombre de points de code classés comme « non-caractères » : cela signifie qu’ils peuvent être utilisés à des fins internes dans les applications, mais ne peuvent pas servir à l’échange de texte. Il s’agit des deux dernières entrées de chaque plan Unicode ([0xfffe..0xffff], [0x1fffe..0x1ffff], etc.) ainsi que des entrées comprises dans la plage [0xfdd0..0xfdef].
Remarque : avant Qt 6, cette fonction prenait un argument de type « uint ».
Il s’agit d’une fonction surchargée.
[constexpr noexcept] bool QChar::isNull() const
Renvoie « true » si le caractère est le caractère Unicode 0x0000 («\0 ») ; sinon, renvoie « false ».
[constexpr noexcept] bool QChar::isNumber() const
Renvoie « true » si le caractère est un chiffre (catégories « Number_* », pas uniquement 0 à 9) ; sinon, renvoie « false ».
Voir également isDigit().
[static constexpr noexcept] bool QChar::isNumber(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` est un chiffre (catégories `Number_*`, pas seulement 0 à 9) ; sinon, renvoie ` false`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
Voir également isDigit().
[noexcept] bool QChar::isPrint() const
Renvoie « true » si le caractère est imprimable ; sinon, renvoie « false ». Il s'agit de tout caractère n'appartenant pas à la catégorie Other_*.
Notez que cela ne donne aucune indication quant à la disponibilité du caractère dans une police particulière.
[static noexcept] bool QChar::isPrint(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » est un caractère imprimable ; sinon, renvoie « false ». Il s'agit de tout caractère n'appartenant pas à la catégorie « Other_* ».
Notez que cela ne donne aucune indication quant à la disponibilité du caractère dans une police particulière.
Remarque : avant Qt 6, cette fonction prenait un argument de type « uint ».
Il s'agit d'une fonction surchargée.
[noexcept] bool QChar::isPunct() const
Renvoie « true » si le caractère est un signe de ponctuation (catégories « Punctuation_* ») ; sinon, renvoie « false ».
[static noexcept] bool QChar::isPunct(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » est un signe de ponctuation (catégories « Punctuation_* ») ; sinon, renvoie « false ».
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s’agit d’une fonction surchargée.
[constexpr noexcept] bool QChar::isSpace() const
Renvoie « true » si le caractère est un caractère de séparation (catégories « Separator_* » ou certains points de code de la catégorie « Other_Control ») ; sinon, renvoie « false ».
[static constexpr noexcept] bool QChar::isSpace(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` est un caractère de séparation (catégories `Separator_*` ou certains points de code de la catégorie ` Other_Control `) ; sinon, renvoie ` false`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isSurrogate() const
Renvoie « true » si l'QChar e contient un point de code situé soit dans la partie haute, soit dans la partie basse de la plage des caractères de substitution UTF-16 (par exemple, si son point de code se trouve dans la plage [0xd800..0xdfff]) ; sinon, renvoie « false ».
[static constexpr noexcept] bool QChar::isSurrogate(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` contient un point de code situé soit dans la partie haute, soit dans la partie basse de la plage des caractères de substitution UTF-16 (par exemple, si son point de code se trouve dans la plage [0xd800..0xdfff]) ; renvoie `false` dans le cas contraire.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[noexcept] bool QChar::isSymbol() const
Renvoie « true » si le caractère est un symbole (catégories Symbol_*) ; sinon, renvoie « false ».
[static noexcept] bool QChar::isSymbol(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` est un symbole (catégories `Symbol_*`) ; sinon, renvoie ` false`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isTitleCase() const
Renvoie true si le caractère est une lettre en majuscules de titre ; par exemple, category() donne Letter_Titlecase.
Voir également isLower(), toUpper(), toLower() et toTitleCase().
[static constexpr noexcept] bool QChar::isTitleCase(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » est une lettre en majuscules de titre ; par exemple, « category() » renvoie « Letter_Titlecase ».
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s’agit d’une fonction surchargée.
Voir également isLower(), toUpper(), toLower() et toTitleCase().
[constexpr noexcept] bool QChar::isUpper() const
Renvoie « true » si le caractère est une lettre majuscule ; par exemple, « category() » donne « Letter_Uppercase ».
Voir également isLower(), toUpper() et toLower().
[static constexpr noexcept] bool QChar::isUpper(char32_t ucs4)
Renvoie « true » si le caractère encodé en UCS-4 spécifié par « ucs4 » est une lettre majuscule ; par exemple, « category() » renvoie « Letter_Uppercase ».
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
Voir également isLower(), toUpper() et toLower().
[noexcept] QChar::JoiningType QChar::joiningType() const
Renvoie des informations sur les attributs de type de jonction du caractère (nécessaires pour certaines langues telles que l'arabe ou le syriaque).
[static noexcept] QChar::JoiningType QChar::joiningType(char32_t ucs4)
Renvoie des informations sur les attributs de type de jonction du caractère encodé en UCS-4 spécifié par ` ucs4 ` (nécessaires pour certaines langues telles que l'arabe ou le syriaque).
Remarque : avant Qt 6, cette fonction prenait un argument de type « uint ».
Il s'agit d'une fonction surchargée.
[static constexpr noexcept] char16_t QChar::lowSurrogate(char32_t ucs4)
Renvoie la partie « low surrogate » d’un point de code encodé en UCS-4. Le résultat renvoyé n’est pas défini si ucs4 est inférieur à 0x10000.
Remarque : avant Qt 6, cette fonction prenait un argument « uint » et renvoyait « ushort ».
[noexcept] QChar QChar::mirroredChar() const
Renvoie le caractère inversé si ce caractère est un caractère inversé ; sinon, renvoie le caractère lui-même.
Voir également hasMirrored().
[static noexcept] char32_t QChar::mirroredChar(char32_t ucs4)
Renvoie le caractère inversé si le caractère codé en UCS-4 spécifié par ` ucs4 ` est un caractère inversé ; sinon, renvoie le caractère lui-même.
Remarque : Avant Qt 6, cette fonction prenait un argument uint et renvoyait uint.
Il s’agit d’une fonction surchargée.
Voir aussi hasMirrored().
[static constexpr noexcept] bool QChar::requiresSurrogates(char32_t ucs4)
Renvoie ` true ` si le caractère encodé en UCS-4 spécifié par ` ucs4 ` peut être divisé en parties haute et basse d’un substitut UTF-16 (par exemple, si son point de code est supérieur ou égal à 0x10000) ; `false` dans le cas contraire.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
[constexpr noexcept] uchar QChar::row() const
Renvoie la ligne (octet le plus significatif) du caractère Unicode.
Voir également la fonction ` cell()`.
[noexcept] QChar::Script QChar::script() const
Renvoie la valeur de la propriété « script » Unicode associée à ce caractère.
[static noexcept] QChar::Script QChar::script(char32_t ucs4)
Renvoie la valeur de la propriété « script » Unicode du caractère spécifié sous sa forme codée en UCS-4, à savoir ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint `.
Il s'agit d'une fonction surchargée.
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(char16_t high, char16_t low)
Convertit une paire de substituts UTF-16 dont les valeurs « high » et « low » sont spécifiées en son point de code codé en UCS-4.
Remarque : avant Qt 6, cette fonction prenait des arguments de type « ushort » et renvoyait des valeurs de type « uint ».
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(QChar high, QChar low)
Convertit une paire de substituts UTF-16 (high, low) en son point de code encodé en UCS-4.
Remarque : avant Qt 6, cette fonction renvoyait uint.
Il s'agit d'une fonction surchargée.
[noexcept] QChar QChar::toCaseFolded() const
Renvoie l'équivalent du caractère après conversion de la casse. Pour la plupart des caractères Unicode, cela revient à appeler la fonction ` toLower()`.
[static noexcept] char32_t QChar::toCaseFolded(char32_t ucs4)
Renvoie l'équivalent en majuscules/minuscules du caractère encodé en UCS-4 spécifié par ` ucs4`. Pour la plupart des caractères Unicode, cela revient au même que ` toLower()`.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint ` et renvoyait ` uint`.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] char QChar::toLatin1() const
Renvoie le caractère Latin-1 équivalent à QChar, ou 0. Cette fonction est principalement utile pour les logiciels non internationalisés.
Remarque : il n’est pas possible de distinguer un caractère non Latin-1 d’un caractère Latin-1 0 (NUL). Privilégiez l’utilisation de ` unicode()` (), qui ne présente pas cette ambiguïté.
Voir aussi unicode().
[noexcept] QChar QChar::toLower() const
Renvoie l'équivalent en minuscules si le caractère est en majuscules ou en majuscules de titre ; sinon, renvoie le caractère lui-même.
[static noexcept] char32_t QChar::toLower(char32_t ucs4)
Renvoie l'équivalent en minuscules du caractère encodé en UCS-4 spécifié par ` ucs4 ` si ce caractère est en majuscules ou en majuscules de titre ; sinon, renvoie le caractère lui-même.
Remarque : Avant Qt 6, cette fonction prenait un argument de type ` uint ` et renvoyait ` uint`.
Il s'agit d'une fonction surchargée.
[noexcept] QChar QChar::toTitleCase() const
Renvoie l'équivalent en majuscules et minuscules si le caractère est en minuscule ou en majuscule ; sinon, renvoie le caractère lui-même.
[static noexcept] char32_t QChar::toTitleCase(char32_t ucs4)
Renvoie l'équivalent en majuscules/minuscules du caractère encodé en UCS-4 spécifié par ` ucs4 ` si ce caractère est en minuscules ou en majuscules ; sinon, renvoie le caractère lui-même.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint ` et renvoyait ` uint`.
Il s'agit d'une fonction surchargée.
[noexcept] QChar QChar::toUpper() const
Renvoie l'équivalent en majuscules si le caractère est en minuscules ou en majuscules de titre ; sinon, renvoie le caractère lui-même.
Remarque : cette fonction renvoie également le caractère d'origine dans le cas rare où la forme majuscule du caractère nécessite deux caractères ou plus.
Voir aussi QString::toUpper().
[static noexcept] char32_t QChar::toUpper(char32_t ucs4)
Renvoie l'équivalent en majuscules du caractère encodé en UCS-4 spécifié par ` ucs4 ` si ce caractère est en minuscules ou en majuscules de titre ; sinon, renvoie le caractère lui-même.
Remarque : cette fonction renvoie également le caractère d'origine dans les rares cas où la forme majuscule du caractère nécessite deux caractères ou plus.
Remarque : avant Qt 6, cette fonction prenait un argument de type ` uint ` et renvoyait une ` uint`.
Il s'agit d'une fonction surchargée.
Voir également ` QString::toUpper()`.
[constexpr noexcept] char16_t &QChar::unicode()
Renvoie une référence à la valeur numérique Unicode de l'QChar.
[constexpr noexcept] char16_t QChar::unicode() const
Renvoie la valeur numérique Unicode de l'QChar.
[noexcept] QChar::UnicodeVersion QChar::unicodeVersion() const
Renvoie la version Unicode dans laquelle ce caractère a été introduit.
[static noexcept] QChar::UnicodeVersion QChar::unicodeVersion(char32_t ucs4)
Renvoie la version Unicode qui a introduit le caractère spécifié sous sa forme codée en UCS-4, à savoir ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument de type « uint ».
Il s'agit d'une fonction surchargée.
Éléments non membres associés
[constexpr noexcept] bool operator!=(const QChar &c1, const QChar &c2)
Renvoie « true » si « c1 » et « c2 » ne correspondent pas au même caractère Unicode ; sinon, renvoie « false ».
[constexpr noexcept] bool operator<(const QChar &c1, const QChar &c2)
Renvoie « true » si la valeur numérique Unicode de « c1 » est inférieure à celle de « c2 » ; sinon, renvoie « false ».
QDataStream &operator<<(QDataStream &out, QChar chr)
Écrit le caractère chr dans le flux out.
Voir également Sérialisation des types de données Qt.
[constexpr noexcept] bool operator<=(const QChar &c1, const QChar &c2)
Renvoie « true » si la valeur numérique Unicode de « c1 » est inférieure ou égale à celle de « c2 » ; sinon, renvoie « false ».
[constexpr noexcept] bool operator==(const QChar &c1, const QChar &c2)
Renvoie « true » si « c1 » et « c2 » correspondent au même caractère Unicode ; sinon, renvoie « false ».
[constexpr noexcept] bool operator>(const QChar &c1, const QChar &c2)
Renvoie « true » si la valeur numérique Unicode de « c1 » est supérieure à celle de « c2 » ; sinon, renvoie « false ».
[constexpr noexcept] bool operator>=(const QChar &c1, const QChar &c2)
Renvoie « true » si la valeur numérique Unicode de « c1 » est supérieure ou égale à celle de « c2 » ; sinon, renvoie « false ».
QDataStream &operator>>(QDataStream &in, QChar &chr)
Lit un caractère du flux in et le stocke dans la variable ` chr`.
Voir également Sérialisation des types de données 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.
