QChar Class
La classe QChar fournit un caractère Unicode de 16 bits. Plus d'informations...
| 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 de caractères.
Cette classe est fortement comparable.
Cette classe est fortement comparable à char16_t, QString, QStringView, QLatin1StringView, et QUtf8StringView.
Cette classe est fortement comparable à const char *, QByteArray, et QByteArrayView.
Le contenu du tableau d'octets est interprété en UTF-8.
Remarque : toutes les fonctions de cette classe sont réentrantes.
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) |
Non-membres apparenté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 aucun marquage ni structure. Cette classe représente une telle entité. Elle est légère et peut donc être utilisée partout. La plupart des compilateurs la traitent comme un unsigned short.
QChar fournit un ensemble complet de fonctions de test/classification, de conversion vers et depuis d'autres formats, de conversion de l'Unicode composé vers l'Unicode décomposé, et essaie de comparer et de convertir les majuscules et les minuscules si vous le lui demandez.
Les fonctions de classification comprennent des fonctions comme celles de l'en-tête standard C++ <cctype> (anciennement <ctype.h>), mais elles opèrent sur toute la gamme des caractères Unicode, et pas seulement sur la gamme ASCII. Elles renvoient toutes la valeur "vrai" si le caractère est d'un certain type, sinon elles renvoient la valeur "faux". Ces fonctions de classification sont isNull() (renvoie true si le caractère est '\0'), isPrint() (vrai si le caractère est n'importe quel type de caractère imprimable, y compris l'espace blanc), isPunct() (n'importe quel type de ponctuation), isMark() (marque Unicode), isLetter() (une lettre), isNumber() (n'importe quel type de caractère numérique, pas seulement 0-9), isLetterOrNumber(), et isDigit() (chiffres décimaux). Tous ces éléments sont des enveloppes autour de category() qui renvoient la catégorie définie par Unicode pour chaque caractère. Certains d'entre eux calculent également les propriétés dérivées (par exemple isSpace() renvoie true si le caractère est de la catégorie Separator_* ou un point de code exceptionnel de la catégorie Other_Control ).
QChar fournit également direction(), qui indique le sens d'écriture "naturel" de ce caractère. La fonction joiningType() indique comment le caractère se joint à ses voisins (nécessaire surtout pour l'arabe ou le syriaque) et enfin hasMirrored(), qui indique si le caractère doit être reflété lorsqu'il est imprimé dans son sens d'écriture "non naturel".
Les caractères Unicode composés (comme ring) peuvent être convertis en caractères Unicode décomposés ("a" suivi de "anneau au-dessus") en utilisant decomposition().
Dans Unicode, la comparaison n'est pas nécessairement possible et la conversion des majuscules et des minuscules est au mieux très difficile. L'Unicode, qui couvre le monde "entier", inclut également la plupart des problèmes de casse et de tri du monde. operator==() et ses amis effectuent des comparaisons basées uniquement sur la valeur numérique Unicode (point de code) des caractères, et toUpper() et toLower() effectuent des changements de casse lorsque le caractère a un équivalent majuscule/minuscule bien défini. Pour les comparaisons dépendant de la langue locale, utilisez QString::localeAwareCompare().
Les fonctions de conversion comprennent unicode() (vers un scalaire), toLatin1() (vers un scalaire, mais convertit tous les caractères non latins-1 en 0), row() (donne la ligne Unicode), cell() (donne la cellule Unicode), digitValue() (donne la valeur entière de n'importe lequel des nombreux caractères numériques), et un grand nombre de constructeurs.
QChar fournit des constructeurs et des opérateurs de conversion qui facilitent la conversion vers et depuis les chartraditionnels de 8 bits. 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 de QChar sont explicit. Cela permet d'éviter des erreurs dangereuses en mélangeant accidentellement des types intégraux et des chaînes de caractères.
Pour plus d'informations, voir "A propos de la base de données des caractères Unicode".
Voir aussi Unicode, QString, et QLatin1Char.
Documentation sur les types de membres
enum QChar::Category
Cette énumération présente les 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 classe Unicode Mc |
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 en 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 également category().
enum QChar::Decomposition
Ce type d'énumération définit les attributs de décomposition Unicode. Voir la norme Unicode pour 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 decomposition().
enum QChar::Direction
Ce type d'énumération définit les attributs de direction Unicode. Voir la norme Unicode pour une description des valeurs.
Afin de se conformer aux conventions de dénomination C/C++, "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 du type de jointure Unicode. Voir la norme Unicode pour une description des valeurs.
Afin de se conformer aux conventions de dénomination C/C++, "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 des propriétés du script Unicode.
Pour plus de détails sur les valeurs des propriétés de script Unicode, voir l'annexe 24 de la norme Unicode.
Afin de se conformer aux conventions de dénomination C/C++, "Script_" est ajouté aux codes utilisés dans la norme Unicode.
| Constante | Valeur | Description de la constante |
|---|---|---|
QChar::Script_Unknown | 0 | Pour les points de code non assignés, à usage privé, sans caractère et de substitution. |
QChar::Script_Inherited | 1 | Pour les caractères qui peuvent être utilisés avec plusieurs écritures et qui héritent leur écriture des caractères précédents. Il s'agit notamment des marques d'espacement, des marques d'enfermement et des caractères de jonction ou de non-jonction de largeur nulle. |
QChar::Script_Common | 2 | Pour les caractères qui peuvent être utilisés avec plusieurs écritures et qui n'héritent pas de leur écriture 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 | Un QChar 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 n'a pas de glyphe pour un certain point de code. Un point d'interrogation spécial est souvent utilisé. Les codecs utilisent ce point de 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 de tels objets ne peuvent pas être présentés. |
QChar::ByteOrderMark | 0xfeff | |
QChar::ByteOrderSwapped | 0xfffe | |
QChar::ParagraphSeparator | 0x2029 | |
QChar::LineSeparator | 0x2028 | |
QChar::VisualTabCharacter (since Qt 6.2) | 0x2192 | Utilisé pour représenter une tabulation sous la forme d'une flèche horizontale. |
QChar::LastValidCodePoint | 0x10ffff |
enum QChar::UnicodeVersion
Spécifie quelle version de la norme Unicode a introduit un certain caractère.
| Constante | Valeur | Description du caractère |
|---|---|---|
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 | La valeur n'est attribuée à aucun caractère dans la version 8.0 d'Unicode. |
Voir aussi unicodeVersion() et currentUnicodeVersion().
Documentation des fonctions membres
[constexpr noexcept] QChar::QChar()
Construit un QChar nul ('\0').
Voir aussi isNull().
[constexpr noexcept] QChar::QChar(QChar::SpecialCharacter ch)
Construit un QChar pour la valeur de caractère prédéfinie ch.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument supportés par les constructeurs QChar.
[constexpr noexcept] QChar::QChar(QLatin1Char ch)
Construit un QChar correspondant au caractère ASCII/Latin-1 ch.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument pris en charge par les constructeurs QChar.
[constexpr noexcept] QChar::QChar(char ch)
Construit un QChar correspondant au caractère ASCII/Latin-1 ch.
Note : Ce constructeur n'est pas disponible lorsque QT_NO_CAST_FROM_ASCII est défini.
Note : 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 pas tout ce qui est implicitement converti en ce type. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument supportés par les constructeurs QChar.
Voir aussi QT_NO_CAST_FROM_ASCII.
[constexpr noexcept] QChar::QChar(char16_t ch)
Construit un QChar correspondant au caractère UTF-16 ch.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument supportés par les constructeurs QChar.
[default] QChar::QChar(char32_t code)
Construit un QChar pour le caractère avec le point de code Unicode code.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument pris en charge par les constructeurs QChar.
[explicit constexpr noexcept] QChar::QChar(int code)
Construit un QChar pour le caractère avec le point de code Unicode code.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument pris en charge par les constructeurs QChar.
[constexpr noexcept] QChar::QChar(short code)
Construit un QChar pour le caractère avec le point de code Unicode code.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument pris en charge par les constructeurs QChar.
[explicit constexpr noexcept] QChar::QChar(uchar ch)
Construit un QChar correspondant au caractère ASCII/Latin-1 ch.
Note : Ce constructeur n'est pas disponible lorsque QT_NO_CAST_FROM_ASCII ou QT_RESTRICTED_CAST_FROM_ASCII est défini.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument supportés par les constructeurs QChar.
Voir aussi QT_NO_CAST_FROM_ASCII et QT_RESTRICTED_CAST_FROM_ASCII.
[explicit constexpr noexcept] QChar::QChar(uint code)
Construit un QChar pour le caractère avec le point de code Unicode code.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument pris en charge par les constructeurs QChar.
[constexpr noexcept] QChar::QChar(ushort code)
Construit un QChar pour le caractère avec le point de code Unicode code.
Note : 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 pas tout ce qui se convertit implicitement en lui. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument pris en charge par les constructeurs QChar.
[constexpr noexcept] QChar::QChar(wchar_t ch)
Construit un QChar correspondant au caractère large ch.
Note : Ce constructeur n'est disponible que sous Windows.
Note : 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 est implicitement converti en ce type. Une solution rétrocompatible consiste à effectuer un cast explicite vers l'un des types d'argument supportés par les constructeurs QChar.
[explicit constexpr noexcept] QChar::QChar(uchar cell, uchar row)
Construit un QChar pour la cellule Unicode cell dans la ligne 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é UCS-4 spécifié par ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] uchar QChar::cell() const
Renvoie la cellule (octet le moins significatif) du caractère Unicode.
Voir aussi row().
[noexcept] unsigned char QChar::combiningClass() const
Renvoie la classe de combinaison du caractère telle qu'elle est définie dans la norme Unicode. Cette information est principalement utile pour le positionnement des marques attachées à un caractère de base.
Le moteur de rendu de texte de Qt Positioning utilise cette information pour positionner correctement les marques d'espacement autour d'un caractère de base.
[static noexcept] unsigned char QChar::combiningClass(char32_t ucs4)
Renvoie la classe de combinaison pour le caractère encodé UCS-4 spécifié par ucs4, tel que défini dans la norme Unicode.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[static noexcept] QChar::UnicodeVersion QChar::currentUnicodeVersion()
Renvoie la dernière version d'Unicode prise en charge.
QString QChar::decomposition() const
Décompose un caractère en ses éléments constitutifs. Renvoie une chaîne vide si aucune décomposition n'existe.
[static] QString QChar::decomposition(char32_t ucs4)
Décompose le caractère encodé UCS-4 spécifié par ucs4 en ses éléments constitutifs. Retourne une chaîne vide si aucune décomposition n'existe.
Note : Avant Qt 6, cette fonction prenait un argument 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. Retourne QChar::NoDecomposition si aucune décomposition n'existe.
[static noexcept] QChar::Decomposition QChar::decompositionTag(char32_t ucs4)
Renvoie la balise définissant la composition du caractère encodé UCS-4 spécifié par ucs4. Retourne QChar::NoDecomposition si aucune décomposition n'existe.
Note : Avant Qt 6, cette fonction prenait un argument 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é UCS-4, ucs4, ou -1 si le caractère n'est pas un chiffre.
Note : Avant Qt 6, cette fonction prenait un argument 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é UCS-4 spécifié par ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument 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. Ceci est principalement utile pour les logiciels non internationalisés.
Une alternative consiste à utiliser QLatin1Char.
Voir aussi toLatin1() et unicode().
[static constexpr noexcept, since 6.0] QChar QChar::fromUcs2(char16_t c)
Construit un QChar à partir du caractère UTF-16 c.
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
char16_t chars[2], - qui peut être implicitement converti en QStringView, et
- itérée avec une boucle for rangée en C++11.
Si c nécessite des substituts, chars[0] contient le substitut haut et chars[1] le substitut bas, et QStringView a une taille de 2. Sinon, chars[0] contient c et chars[1] est null, et 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é si la direction du texte est inversée ; sinon, renvoie false.
Un équivalent un peu plus rapide de (ch.mirroredChar() != ch).
Voir aussi mirroredChar().
[static noexcept] bool QChar::hasMirrored(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 doit être inversé si le sens du texte est inversé ; sinon, renvoie false.
Un équivalent un peu plus rapide de (QChar::mirroredChar(ucs4) != ucs4).
Remarque : avant Qt 6, cette fonction prenait un argument 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 de substitution haute d'un point de code codé en UCS-4. Le résultat renvoyé est indéfini si ucs4 est plus petit que 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 aussi isNumber().
[static constexpr noexcept] bool QChar::isDigit(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est un chiffre décimal (Number_DecimalDigit) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
Voir aussi isNumber().
[constexpr noexcept] bool QChar::isHighSurrogate() const
Renvoie true si QChar est la partie haute d'un substitut UTF16 (par exemple si son point de code se situe dans l'intervalle [0xd800..0xdbff]) ; faux sinon.
[static constexpr noexcept] bool QChar::isHighSurrogate(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est la partie haute d'un substitut UTF16 (par exemple si son point de code est dans l'intervalle [0xd800..0xdbff]) ; faux sinon.
Remarque : avant Qt 6, cette fonction prenait un argument 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 encodé UCS-4 spécifié par ucs4 est une lettre (catégories Letter_*) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument 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é UCS-4 spécifié par ucs4 est une lettre ou un chiffre (catégories Letter_* ou Number_*) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isLowSurrogate() const
Renvoie true si QChar est la partie basse d'un substitut UTF16 (par exemple si son point de code se situe dans l'intervalle [0xdc00..0xdfff]) ; faux sinon.
[static constexpr noexcept] bool QChar::isLowSurrogate(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est la partie basse d'un substitut UTF16 (par exemple si son point de code est dans l'intervalle [0xdc00..0xdfff]) ; faux sinon.
Remarque : avant Qt 6, cette fonction prenait un argument 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() est Letter_Lowercase.
Voir aussi isUpper(), toLower() et toUpper().
[static constexpr noexcept] bool QChar::isLower(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est une lettre minuscule, par exemple category() est Letter_Lowercase.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
Voir aussi 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é UCS-4 spécifié par ucs4 est une marque (catégories Mark_*) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isNonCharacter() const
Retourne true si le QChar est un non caractère, false sinon.
Unicode possède un certain nombre de points de code qui sont classés comme "non-caractères", c'est-à-dire qu'ils peuvent être utilisés à des fins internes dans les applications mais ne peuvent pas être utilisés pour 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 de la plage [0xfdd0..0xfdef].
[static constexpr noexcept] bool QChar::isNonCharacter(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est un non-caractère ; false sinon.
Unicode possède un certain nombre de points de code qui sont classés comme "non-caractères", c'est-à-dire qu'ils peuvent être utilisés à des fins internes dans les applications mais ne peuvent pas être utilisés pour 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 de l'intervalle [0xfdd0..0xfdef].
Remarque : avant Qt 6, cette fonction prenait un argument 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 nombre (catégories Number_*, pas seulement 0-9) ; sinon, renvoie false.
Voir aussi isDigit().
[static constexpr noexcept] bool QChar::isNumber(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est un nombre (catégories Number_*, pas seulement 0-9) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
Voir aussi 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 permet pas de savoir si le caractère est disponible dans une police particulière.
[static noexcept] bool QChar::isPrint(char32_t ucs4)
Renvoie true si le caractère encodé 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 sur la disponibilité du caractère dans une police particulière.
Note : Avant Qt 6, cette fonction prenait un argument 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é UCS-4 spécifié par ucs4 est un signe de ponctuation (catégories Punctuation_*) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument 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 séparateur (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é UCS-4 spécifié par ucs4 est un caractère séparateur (catégories Separator_* ou certains points de code de la catégorie Other_Control ) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isSurrogate() const
Renvoie true si le site QChar contient un point de code qui se trouve dans la partie haute ou basse de la plage de substitution UTF-16 (par exemple, si son point de code se trouve dans la plage [0xd800..0xdfff]) ; faux sinon.
[static constexpr noexcept] bool QChar::isSurrogate(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 contient un point de code qui se trouve dans la partie haute ou basse de la plage de substitution UTF-16 (par exemple si son point de code se trouve dans la plage [0xd800..0xdfff]) ; faux sinon.
Remarque : avant Qt 6, cette fonction prenait un argument 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é UCS-4 spécifié par ucs4 est un symbole (catégories Symbol_*) ; sinon, renvoie false.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[constexpr noexcept] bool QChar::isTitleCase() const
Renvoie true si le caractère est une lettre majuscule, par exemple category() est Letter_Titlecase.
Voir aussi isLower(), toUpper(), toLower() et toTitleCase().
[static constexpr noexcept] bool QChar::isTitleCase(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est une lettre majuscule, par exemple category() est Letter_Titlecase.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
Voir aussi isLower(), toUpper(), toLower() et toTitleCase().
[constexpr noexcept] bool QChar::isUpper() const
Renvoie true si le caractère est une lettre majuscule, par exemple category() est Letter_Uppercase.
Voir aussi isLower(), toUpper() et toLower().
[static constexpr noexcept] bool QChar::isUpper(char32_t ucs4)
Renvoie true si le caractère encodé UCS-4 spécifié par ucs4 est une lettre majuscule, par exemple category() est Letter_Uppercase.
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
Voir aussi isLower(), toUpper() et toLower().
[noexcept] QChar::JoiningType QChar::joiningType() const
Renvoie des informations sur les attributs du type de jointure du caractère (nécessaire pour certaines langues comme l'arabe ou le syriaque).
[static noexcept] QChar::JoiningType QChar::joiningType(char32_t ucs4)
Renvoie des informations sur les attributs du type de jointure du caractère encodé UCS-4 spécifié par ucs4 (nécessaire pour certaines langues comme l'arabe ou le syriaque).
Note : Avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
[static constexpr noexcept] char16_t QChar::lowSurrogate(char32_t ucs4)
Renvoie la partie de substitution basse d'un point de code codé en UCS-4. Le résultat renvoyé est indéfini si ucs4 est plus petit que 0x10000.
Remarque : avant Qt 6, cette fonction prenait un argument uint et renvoyait ushort.
[noexcept] QChar QChar::mirroredChar() const
Renvoie le caractère miroir si ce caractère est un caractère miroir, sinon renvoie le caractère lui-même.
Voir aussi hasMirrored().
[static noexcept] char32_t QChar::mirroredChar(char32_t ucs4)
Renvoie le caractère miroir si le caractère encodé UCS-4 spécifié par ucs4 est un caractère miroir ; sinon, renvoie le caractère lui-même.
Remarque : avant Qt XML 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é UCS-4 spécifié par ucs4 peut être divisé en parties haute et basse d'un substitut UTF16 (par exemple si son point de code est supérieur ou égal à 0x10000) ; faux dans le cas contraire.
Remarque : avant Qt XML 6, cette fonction prenait un argument uint.
[constexpr noexcept] uchar QChar::row() const
Renvoie la ligne (octet le plus significatif) du caractère Unicode.
Voir aussi cell().
[noexcept] QChar::Script QChar::script() const
Renvoie la valeur de la propriété de script Unicode pour ce caractère.
[static noexcept] QChar::Script QChar::script(char32_t ucs4)
Renvoie la valeur de la propriété de script Unicode pour le caractère spécifié dans sa forme encodée UCS-4 sous la forme ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument 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 UTF16 avec les valeurs high et low en son point de code encodé UCS-4.
Note : Avant Qt 6, cette fonction prenait des arguments ushort et renvoyait uint.
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(QChar high, QChar low)
Convertit une paire de substituts UTF16 (high, low) en son point de code encodé 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 plié en casse. Pour la plupart des caractères Unicode, c'est la même chose que toLower().
[static noexcept] char32_t QChar::toCaseFolded(char32_t ucs4)
Renvoie l'équivalent plié en casse du caractère encodé UCS-4 spécifié par ucs4. Pour la plupart des caractères Unicode, c'est la même chose que toLower().
Remarque : Avant Qt XML 6, cette fonction prenait un argument 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. Ceci est principalement utile pour les logiciels non internationalisés.
Note : Il n'est pas possible de distinguer un caractère non latin-1 d'un caractère latin-1 0 (NUL). Préférez utiliser 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 minuscules ; 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é UCS-4 spécifié par ucs4 si le caractère est en majuscules ou en minuscules ; sinon, renvoie le caractère lui-même.
Remarque : Avant Qt XML 6, cette fonction prenait un argument uint et renvoyait uint.
Il s'agit d'une fonction surchargée.
[noexcept] QChar QChar::toTitleCase() const
Renvoie l'équivalent de la casse du titre si le caractère est en minuscules ou en majuscules ; sinon, renvoie le caractère lui-même.
[static noexcept] char32_t QChar::toTitleCase(char32_t ucs4)
Renvoie l'équivalent en majuscules et minuscules du caractère encodé UCS-4 spécifié par ucs4 si le caractère est en minuscules ou en majuscules ; sinon, renvoie le caractère lui-même.
Remarque : Avant Qt XML 6, cette fonction prenait un argument 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 ; sinon, renvoie le caractère lui-même.
Remarque : cette fonction renvoie également le caractère original 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é UCS-4 spécifié par ucs4 si le caractère est en minuscules ou en majuscules ; sinon, renvoie le caractère lui-même.
Note : Cette fonction renvoie également le caractère original dans le cas rare où la forme majuscule du caractère nécessite deux caractères ou plus.
Remarque : Avant Qt XML 6, cette fonction prenait un argument uint et renvoyait uint.
Il s'agit d'une fonction surchargée.
Voir aussi QString::toUpper().
[constexpr noexcept] char16_t &QChar::unicode()
Renvoie une référence à la valeur numérique Unicode de QChar.
[constexpr noexcept] char16_t QChar::unicode() const
Renvoie la valeur numérique Unicode de l'adresse QChar.
[noexcept] QChar::UnicodeVersion QChar::unicodeVersion() const
Renvoie la version d'Unicode qui a introduit ce caractère.
[static noexcept] QChar::UnicodeVersion QChar::unicodeVersion(char32_t ucs4)
Renvoie la version d'Unicode qui a introduit le caractère spécifié dans sa forme encodée UCS-4 sous la forme ucs4.
Remarque : avant Qt 6, cette fonction prenait un argument uint.
Il s'agit d'une fonction surchargée.
Non-membres apparentés
[constexpr noexcept] bool operator!=(const QChar &c1, const QChar &c2)
Renvoie true si c1 et c2 ne sont pas le 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 char chr dans le flux out.
Voir aussi Serializing Qt Data Types (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 sont le 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 dans le caractère chr.
Voir aussi Serializing Qt Data Types (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.
