Auf dieser Seite

QChar Class

Die Klasse „QChar“ stellt ein 16-Bit-Unicode-Zeichen bereit. Mehr...

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

Hinweis: Alle Funktionen dieser Klasse sind reentrant.

QChar-Vergleiche

KategorieVergleichbare TypenBeschreibung
strongQChar
strongchar16_t, QString, QStringView, QLatin1StringView und QUtf8StringView.
strongconst char *, QByteArray und QByteArrayView.Der Inhalt des Byte-Arrays wird als UTF-8 interpretiert.

Öffentliche Typen

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 }

Öffentliche Funktionen

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

Statische öffentliche Mitglieder

QChar::Category category(char32_t ucs4)
unsigned char combiningClass(char32_t ucs4)
QChar::UnicodeVersion currentUnicodeVersion()
QString decomposition(char32_t ucs4)
QChar::Decomposition decompositionTag(char32_t ucs4)
int digitValue(char32_t ucs4)
QChar::Direction direction(char32_t ucs4)
QChar fromLatin1(char c)
(since 6.0) QChar fromUcs2(char16_t c)
(since 6.0) auto fromUcs4(char32_t c)
bool hasMirrored(char32_t ucs4)
char16_t highSurrogate(char32_t ucs4)
bool isDigit(char32_t ucs4)
bool isHighSurrogate(char32_t ucs4)
bool isLetter(char32_t ucs4)
bool isLetterOrNumber(char32_t ucs4)
bool isLowSurrogate(char32_t ucs4)
bool isLower(char32_t ucs4)
bool isMark(char32_t ucs4)
bool isNonCharacter(char32_t ucs4)
bool isNumber(char32_t ucs4)
bool isPrint(char32_t ucs4)
bool isPunct(char32_t ucs4)
bool isSpace(char32_t ucs4)
bool isSurrogate(char32_t ucs4)
bool isSymbol(char32_t ucs4)
bool isTitleCase(char32_t ucs4)
bool isUpper(char32_t ucs4)
QChar::JoiningType joiningType(char32_t ucs4)
char16_t lowSurrogate(char32_t ucs4)
char32_t mirroredChar(char32_t ucs4)
bool requiresSurrogates(char32_t ucs4)
QChar::Script script(char32_t ucs4)
char32_t surrogateToUcs4(char16_t high, char16_t low)
char32_t surrogateToUcs4(QChar high, QChar low)
char32_t toCaseFolded(char32_t ucs4)
char32_t toLower(char32_t ucs4)
char32_t toTitleCase(char32_t ucs4)
char32_t toUpper(char32_t ucs4)
QChar::UnicodeVersion unicodeVersion(char32_t ucs4)
bool operator!=(const QChar &c1, const QChar &c2)
bool operator<(const QChar &c1, const QChar &c2)
QDataStream &operator<<(QDataStream &out, QChar chr)
bool operator<=(const QChar &c1, const QChar &c2)
bool operator==(const QChar &c1, const QChar &c2)
bool operator>(const QChar &c1, const QChar &c2)
bool operator>=(const QChar &c1, const QChar &c2)
QDataStream &operator>>(QDataStream &in, QChar &chr)

Ausführliche Beschreibung

In Qt sind Unicode-Zeichen 16-Bit-Entitäten ohne Markup oder Struktur. Diese Klasse repräsentiert eine solche Entität. Sie ist ressourcenschonend und kann daher überall eingesetzt werden. Die meisten Compiler behandeln sie wie einen „ unsigned short “.

QChar bietet eine umfassende Palette an Prüf- und Klassifizierungsfunktionen, konvertiert in andere Formate und zurück, wandelt zusammengesetzte Unicode-Zeichen in zerlegte um und führt auf Wunsch Vergleiche sowie Groß-/Kleinschreibung-Umwandlungen durch.

Zu den Klassifizierungsfunktionen gehören Funktionen, wie sie im Standard-C++-Header <cctype> (früher <ctype.h>) enthalten sind, die jedoch auf den gesamten Unicode-Zeichenbereich anwendbar sind und nicht nur auf den ASCII-Bereich beschränkt sind. Sie geben alle „true“ zurück, wenn das Zeichen einem bestimmten Typ entspricht; andernfalls geben sie „false“ zurück. Diese Klassifizierungsfunktionen sind isNull() (gibt „ true “ zurück, wenn das Zeichen „\0 “ ist), isPrint() (true, wenn das Zeichen ein beliebiges druckbares Zeichen ist, einschließlich Leerzeichen), isPunct() (beliebige Satzzeichen), isMark() (Unicode-Markierung), isLetter() (ein Buchstabe), isNumber() (jede Art von numerischem Zeichen, nicht nur 0–9), isLetterOrNumber() und isDigit() (dezimale Ziffern). All dies sind Wrapper um category(), die die Unicode-definierte Kategorie jedes Zeichens zurückgeben. Einige davon berechnen auch die abgeleiteten Eigenschaften (zum Beispiel gibt isSpace() true zurück, wenn das Zeichen zur Kategorie „Separator_*“ gehört oder ein Ausnahmecode-Punkt aus der Kategorie „ Other_Control “ ist).

QChar stellt außerdem die Funktion ` direction()` zur Verfügung, die die „natürliche“ Schreibrichtung dieses Zeichens angibt. Die Funktion ` joiningType()` gibt an, wie das Zeichen mit seinen Nachbarn verbunden ist (vor allem für Arabisch oder Syrisch erforderlich), und schließlich gibt ` hasMirrored()` an, ob das Zeichen gespiegelt werden muss, wenn es in seiner „unnatürlichen“ Schreibrichtung gedruckt wird.

Zusammengesetzte Unicode-Zeichen (wie ring) können mithilfe von decomposition() in zerlegte Unicode-Zeichen („a“ gefolgt von „Ring oben“) umgewandelt werden.

In Unicode ist ein Vergleich nicht unbedingt möglich, und die Groß-/Kleinschreibung umzuwandeln ist bestenfalls sehr schwierig. Unicode, das die „ganze“ Welt abdeckt, umfasst auch die meisten Probleme der Welt in Bezug auf Groß-/Kleinschreibung und Sortierung. Der Operator `==()` und ähnliche Funktionen führen Vergleiche ausschließlich auf der Grundlage des numerischen Unicode-Werts (Codepunkt) der Zeichen durch, während ` toUpper()` und ` toLower()` Groß-/Kleinschreibung ändern, sofern das Zeichen ein klar definiertes Äquivalent in Groß- oder Kleinbuchstaben hat. Für lokalisierungsabhängige Vergleiche verwenden Sie ` QString::localeAwareCompare()`.

Zu den Konvertierungsfunktionen gehören unicode() (in einen Skalar), toLatin1() (in einen Skalar, konvertiert jedoch alle Nicht-Latin-1-Zeichen in 0), row() (liefert die Unicode-Zeile), cell() (liefert die Unicode-Zelle), digitValue() (liefert den ganzzahligen Wert eines beliebigen der zahlreichen Ziffernzeichen) sowie eine Vielzahl von Konstruktoren.

QChar bietet Konstruktoren und Typumwandlungsoperatoren, die die Konvertierung in und aus herkömmlichen 8-Bit- charen vereinfachen. Wenn Sie „ QT_NO_CAST_FROM_ASCII “ und „ QT_NO_CAST_TO_ASCII “ definiert haben, wie in der Dokumentation zu „ QString “ erläutert, müssen Sie explizit „ fromLatin1()“ aufrufen oder „ QLatin1Char “ verwenden, um ein `QChar` aus einem 8-Bit-` char` zu konstruieren, und Sie müssen „ toLatin1()“ aufrufen, um den 8-Bit-Wert zurückzubekommen.

Ab Qt 6.0 sind die meisten QChar-Konstruktoren „ explicit “. Dies dient dazu, gefährliche Fehler zu vermeiden, die entstehen können, wenn ganzzahlige Typen und Zeichenketten versehentlich vermischt werden.

Weitere Informationen finden Sie unter „Über die Unicode-Zeichendatenbank“.

Siehe auch Unicode, „ QString “ und „ QLatin1Char “.

Dokumentation zu Mitgliedstypen

enum QChar::Category

Diese Enumeration ordnet die Unicode-Zeichenkategorien zu.

Die folgenden Zeichen sind in Unicode normativ:

KonstanteWertBeschreibung
QChar::Mark_NonSpacing0Unicode-Klassenname Mn
QChar::Mark_SpacingCombining1Unicode-Klassenname Mn
QChar::Mark_Enclosing2Unicode-Klassenname Me
QChar::Number_DecimalDigit3Unicode-Klassenname Nd
QChar::Number_Letter4Unicode-Klassenname Nl
QChar::Number_Other5Unicode-Klassenname No
QChar::Separator_Space6Unicode-Klassenname Zs
QChar::Separator_Line7Unicode-Klassenname Zl
QChar::Separator_Paragraph8Unicode-Klassenname Zp
QChar::Other_Control9Unicode-Klassenname Cc
QChar::Other_Format10Unicode-Klassenname Cf
QChar::Other_Surrogate11Unicode-Klassenname Cs
QChar::Other_PrivateUse12Unicode-Klassenname Co
QChar::Other_NotAssigned13Unicode-Klassenname Cn

Die folgenden Kategorien sind in Unicode informativ:

KonstanteWertBeschreibung
QChar::Letter_Uppercase14Unicode-Klassenname Lu
QChar::Letter_Lowercase15Unicode-Klassenname Ll
QChar::Letter_Titlecase16Unicode-Klassenname Lt
QChar::Letter_Modifier17Unicode-Klassenname Lm
QChar::Letter_Other18Unicode-Klassenname Lo
QChar::Punctuation_Connector19Unicode-Klassenname Pc
QChar::Punctuation_Dash20Unicode-Klassenname Pd
QChar::Punctuation_Open21Unicode-Klassenname Ps
QChar::Punctuation_Close22Unicode-Klassenname Pe
QChar::Punctuation_InitialQuote23Unicode-Klassenname Pi
QChar::Punctuation_FinalQuote24Unicode-Klassenname Pf
QChar::Punctuation_Other25Unicode-Klassenname Po
QChar::Symbol_Math26Unicode-Klassenname Sm
QChar::Symbol_Currency27Unicode-Klassenname Sc
QChar::Symbol_Modifier28Unicode-Klassenname Sk
QChar::Symbol_Other29Unicode-Klassenname So

Siehe auch „ category()“.

enum QChar::Decomposition

Dieser Enum-Typ definiert die Unicode-Zerlegungsattribute. Eine Beschreibung der Werte finden Sie im Unicode-Standard.

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

Siehe auch ` decomposition()`.

enum QChar::Direction

Dieser Enum-Typ definiert die Unicode-Richtungsattribute. Eine Beschreibung der Werte finden Sie im Unicode-Standard.

Um den Namenskonventionen von C/C++ zu entsprechen, wird den im Unicode-Standard verwendeten Codes „Dir“ vorangestellt.

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

Siehe auch „ direction()“.

enum QChar::JoiningType

seit 5.3

Dieser Enum-Typ definiert die Attribute des Unicode-Verbindungstyps. Eine Beschreibung der Werte finden Sie im Unicode-Standard.

Um den Namenskonventionen von C/C++ zu entsprechen, wird den im Unicode-Standard verwendeten Codes „Joining_“ vorangestellt.

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

Siehe auch ` joiningType()`.

enum QChar::Script

Dieser Enum-Typ definiert die Werte der Unicode-Skript-Eigenschaft.

Einzelheiten zu den Werten der Unicode-Skript-Eigenschaft finden Sie im Anhang Nr. 24 des Unicode-Standards.

Um den Namenskonventionen von C/C++ zu entsprechen, wird den im Unicode-Standard verwendeten Codes „Script_“ vorangestellt.

KonstanteWertBeschreibung
QChar::Script_Unknown0Für nicht zugewiesene, privat genutzte, nicht-zeichenbezogene und Surrogat-Codepunkte.
QChar::Script_Inherited1Für Zeichen, die mit mehreren Schriften verwendet werden können und deren Schrift von den vorangehenden Zeichen übernommen wird. Dazu gehören nicht-raumfüllende Zeichen, umschließende Zeichen sowie Verbindungszeichen und Nicht-Verbindungszeichen mit der Breite Null.
QChar::Script_Common2Für Zeichen, die in mehreren Schriften verwendet werden können und deren Schrift nicht von den vorangehenden Zeichen übernommen wird.
QChar::Script_Adlam (since Qt 5.11)132 
QChar::Script_Ahom (since Qt 5.6)126 
QChar::Script_AnatolianHieroglyphs (since Qt 5.6)127 
QChar::Script_Arabic8 
QChar::Script_Armenian6 
QChar::Script_Avestan80 
QChar::Script_Balinese62 
QChar::Script_Bamum84 
QChar::Script_BassaVah (since Qt 5.5)104 
QChar::Script_Batak93 
QChar::Script_Bengali12 
QChar::Script_BeriaErfe (since Qt 6.11)174 
QChar::Script_Bhaiksuki (since Qt 5.11)133 
QChar::Script_Bopomofo36 
QChar::Script_Brahmi94 
QChar::Script_Braille54 
QChar::Script_Buginese55 
QChar::Script_Buhid44 
QChar::Script_CanadianAboriginal29 
QChar::Script_Carian75 
QChar::Script_CaucasianAlbanian (since Qt 5.5)103 
QChar::Script_Chakma96 
QChar::Script_Cham77 
QChar::Script_Cherokee28 
QChar::Script_Chorasmian (since Qt 5.15)153 
QChar::Script_Coptic46 
QChar::Script_Cuneiform63 
QChar::Script_Cypriot53 
QChar::Script_CyproMinoan (since Qt 6.3)157 
QChar::Script_Cyrillic5 
QChar::Script_Deseret41 
QChar::Script_Devanagari11 
QChar::Script_DivesAkuru (since Qt 5.15)154 
QChar::Script_Dogra (since Qt 5.15)142 
QChar::Script_Duployan (since Qt 5.5)105 
QChar::Script_EgyptianHieroglyphs81 
QChar::Script_Elbasan (since Qt 5.5)106 
QChar::Script_Elymaic (since Qt 5.15)149 
QChar::Script_Ethiopic27 
QChar::Script_Garay (since Qt 6.9)164 
QChar::Script_Georgian25 
QChar::Script_Glagolitic57 
QChar::Script_Gothic40 
QChar::Script_Grantha (since Qt 5.5)107 
QChar::Script_Greek4 
QChar::Script_Gujarati14 
QChar::Script_GunjalaGondi (since Qt 5.15)143 
QChar::Script_Gurmukhi13 
QChar::Script_GurungKhema (since Qt 6.9)165 
QChar::Script_Han37 
QChar::Script_Hangul26 
QChar::Script_HanifiRohingya (since Qt 5.15)144 
QChar::Script_Hanunoo43 
QChar::Script_Hatran (since Qt 5.6)128 
QChar::Script_Hebrew7 
QChar::Script_Hiragana34 
QChar::Script_ImperialAramaic87 
QChar::Script_InscriptionalPahlavi90 
QChar::Script_InscriptionalParthian89 
QChar::Script_Javanese85 
QChar::Script_Kaithi92 
QChar::Script_Kannada18 
QChar::Script_Katakana35 
QChar::Script_Kawi (since Qt 6.5)162 
QChar::Script_KayahLi72 
QChar::Script_Kharoshthi61 
QChar::Script_KhitanSmallScript (since Qt 5.15)155 
QChar::Script_Khmer32 
QChar::Script_Khojki (since Qt 5.5)109 
QChar::Script_Khudawadi (since Qt 5.5)123 
QChar::Script_KiratRai (since Qt 6.9)166 
QChar::Script_Lao22 
QChar::Script_Latin3 
QChar::Script_Lepcha68 
QChar::Script_Limbu47 
QChar::Script_LinearA (since Qt 5.5)110 
QChar::Script_LinearB49 
QChar::Script_Lisu83 
QChar::Script_Lycian74 
QChar::Script_Lydian76 
QChar::Script_Mahajani (since Qt 5.5)111 
QChar::Script_Makasar (since Qt 5.15)145 
QChar::Script_Malayalam19 
QChar::Script_Mandaic95 
QChar::Script_Manichaean (since Qt 5.5)112 
QChar::Script_Marchen (since Qt 5.11)134 
QChar::Script_MasaramGondi (since Qt 5.11)138 
QChar::Script_Medefaidrin (since Qt 5.15)146 
QChar::Script_MeeteiMayek86 
QChar::Script_MendeKikakui (since Qt 5.5)113 
QChar::Script_MeroiticCursive97 
QChar::Script_MeroiticHieroglyphs98 
QChar::Script_Miao99 
QChar::Script_Modi (since Qt 5.5)114 
QChar::Script_Mongolian33 
QChar::Script_Mro (since Qt 5.5)115 
QChar::Script_Multani (since Qt 5.6)129 
QChar::Script_Myanmar24 
QChar::Script_Nabataean (since Qt 5.5)117 
QChar::Script_NagMundari (since Qt 6.3)163 
QChar::Script_Nandinagari (since Qt 5.15)150 
QChar::Script_Newa (since Qt 5.11)135 
QChar::Script_NewTaiLue56 
QChar::Script_Nko66 
QChar::Script_Nushu (since Qt 5.11)139 
QChar::Script_NyiakengPuachueHmong (since Qt 5.15)151 
QChar::Script_Ogham30 
QChar::Script_OlChiki69 
QChar::Script_OlOnal (since Qt 6.9)167 
QChar::Script_OldHungarian (since Qt 5.6)130 
QChar::Script_OldItalic39 
QChar::Script_OldNorthArabian (since Qt 5.5)116 
QChar::Script_OldPermic (since Qt 5.5)120 
QChar::Script_OldPersian60 
QChar::Script_OldSogdian (since Qt 5.15)147 
QChar::Script_OldSouthArabian88 
QChar::Script_OldTurkic91 
QChar::Script_OldUyghur (since Qt 6.3)158 
QChar::Script_Oriya15 
QChar::Script_Osage (since Qt 5.11)136 
QChar::Script_Osmanya52 
QChar::Script_PahawhHmong (since Qt 5.5)108 
QChar::Script_Palmyrene (since Qt 5.5)118 
QChar::Script_PauCinHau (since Qt 5.5)119 
QChar::Script_PhagsPa65 
QChar::Script_Phoenician64 
QChar::Script_PsalterPahlavi (since Qt 5.5)121 
QChar::Script_Rejang73 
QChar::Script_Runic31 
QChar::Script_Samaritan82 
QChar::Script_Saurashtra71 
QChar::Script_Sharada100 
QChar::Script_Shavian51 
QChar::Script_Siddham (since Qt 5.5)122 
QChar::Script_Sidetic (since Qt 6.11)171 
QChar::Script_SignWriting (since Qt 5.6)131 
QChar::Script_Sinhala20 
QChar::Script_Sogdian (since Qt 5.15)148 
QChar::Script_SoraSompeng101 
QChar::Script_Soyombo (since Qt 5.11)140 
QChar::Script_Sundanese67 
QChar::Script_Sunuwar (since Qt 6.9)168 
QChar::Script_SylotiNagri59 
QChar::Script_Syriac9 
QChar::Script_Tagalog42 
QChar::Script_Tagbanwa45 
QChar::Script_TaiLe48 
QChar::Script_TaiTham78 
QChar::Script_TaiViet79 
QChar::Script_TaiYo (since Qt 6.11)172 
QChar::Script_Takri102 
QChar::Script_Tamil16 
QChar::Script_Tangut (since Qt 5.11)137 
QChar::Script_Tangsa (since Qt 6.3)159 
QChar::Script_Telugu17 
QChar::Script_Thaana10 
QChar::Script_Thai21 
QChar::Script_Tibetan23 
QChar::Script_Tifinagh58 
QChar::Script_Tirhuta (since Qt 5.5)124 
QChar::Script_Todhri (since Qt 6.9)169 
QChar::Script_TolongSiki (since Qt 6.11)173 
QChar::Script_Toto (since Qt 6.3)160 
QChar::Script_TuluTigalari (since Qt 6.9)170 
QChar::Script_Ugaritic50 
QChar::Script_Vai70 
QChar::Script_Vithkuqi (since Qt 6.3)161 
QChar::Script_Wancho (since Qt 5.15)152 
QChar::Script_WarangCiti (since Qt 5.5)125 
QChar::Script_Yezidi (since Qt 5.15)156 
QChar::Script_Yi38 
QChar::Script_ZanabazarSquare (since Qt 5.11)141 

Siehe auch script().

enum QChar::SpecialCharacter

KonstanteWertBeschreibung
QChar::Null0x0000Ein „ QChar “ mit diesem Wert isNull().
QChar::Tabulation0x0009Zeichentabulator.
QChar::LineFeed0x000a 
QChar::FormFeed0x000c 
QChar::CarriageReturn0x000d 
QChar::Space0x0020 
QChar::Nbsp0x00a0Schiebespalte.
QChar::SoftHyphen0x00ad 
QChar::ReplacementCharacter0xfffdDas Zeichen, das angezeigt wird, wenn eine Schriftart kein Glyph für einen bestimmten Codepunkt enthält. Oft wird ein spezielles Fragezeichen verwendet. Codecs verwenden diesen Codepunkt, wenn Eingabedaten nicht in Unicode dargestellt werden können.
QChar::ObjectReplacementCharacter0xfffcWird verwendet, um ein Objekt wie beispielsweise ein Bild darzustellen, wenn solche Objekte nicht angezeigt werden können.
QChar::ByteOrderMark0xfeff 
QChar::ByteOrderSwapped0xfffe 
QChar::ParagraphSeparator0x2029 
QChar::LineSeparator0x2028 
QChar::VisualTabCharacter (since Qt 6.2)0x2192Wird verwendet, um eine Tabulatorstelle als horizontalen Pfeil darzustellen.
QChar::LastValidCodePoint0x10ffff 

enum QChar::UnicodeVersion

Gibt an, in welcher Version des Unicode-Standards ein bestimmtes Zeichen eingeführt wurde.

KonstanteWertBeschreibung
QChar::Unicode_1_11Version 1.1
QChar::Unicode_2_02Version 2.0
QChar::Unicode_2_1_23Version 2.1.2
QChar::Unicode_3_04Version 3.0
QChar::Unicode_3_15Version 3.1
QChar::Unicode_3_26Version 3.2
QChar::Unicode_4_07Version 4.0
QChar::Unicode_4_18Version 4.1
QChar::Unicode_5_09Version 5.0
QChar::Unicode_5_110Version 5.1
QChar::Unicode_5_211Version 5.2
QChar::Unicode_6_012Version 6.0
QChar::Unicode_6_113Version 6.1
QChar::Unicode_6_214Version 6.2
QChar::Unicode_6_3 (since Qt 5.3)15Version 6.3
QChar::Unicode_7_0 (since Qt 5.5)16Version 7.0
QChar::Unicode_8_0 (since Qt 5.6)17Version 8.0
QChar::Unicode_9_0 (since Qt 5.11)18Version 9.0
QChar::Unicode_10_0 (since Qt 5.11)19Version 10.0
QChar::Unicode_11_0 (since Qt 5.15)20Version 11.0
QChar::Unicode_12_0 (since Qt 5.15)21Version 12.0
QChar::Unicode_12_1 (since Qt 5.15)22Version 12.1
QChar::Unicode_13_0 (since Qt 5.15)23Version 13.0
QChar::Unicode_14_0 (since Qt 6.3)24Version 14.0
QChar::Unicode_15_0 (since Qt 6.5)25Version 15.0
QChar::Unicode_15_1 (since Qt 6.8)26Version 15.1
QChar::Unicode_16_0 (since Qt 6.9)27Version 16.0
QChar::Unicode_17_0 (since Qt 6.11)28Version 17.0
QChar::Unicode_Unassigned0Der Wert ist in Version 8.0 von Unicode keinem Zeichen zugeordnet.

Siehe auch unicodeVersion() und currentUnicodeVersion().

Dokumentation zu den Member-Funktionen

[constexpr noexcept] QChar::QChar()

Erzeugt ein Null-QChar-Objekt („\0 “).

Siehe auch isNull().

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

Erstellt ein `QChar` für den vordefinierten Zeichenwert ` ch`.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein QChar-Objekt, das dem ASCII/Latin-1-Zeichen „ ch “ entspricht.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein QChar-Objekt, das dem ASCII/Latin-1-Zeichen ch entspricht.

Hinweis: Dieser Konstruktor ist nicht verfügbar, wenn ` QT_NO_CAST_FROM_ASCII ` definiert ist.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktorargumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

Siehe auch „ QT_NO_CAST_FROM_ASCII “.

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

Erzeugt ein QChar-Objekt, das dem UTF-16-Zeichen „ ch “ entspricht.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert wird. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

[implicit] QChar::QChar(char32_t code)

Erzeugt ein `QChar`-Objekt für das Zeichen mit dem Unicode-Codepunkt ` code`.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein `QChar` für das Zeichen mit dem Unicode-Codepunkt ` code`.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein `QChar` für das Zeichen mit dem Unicode-Codepunkt ` code`.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein QChar-Objekt, das dem ASCII/Latin-1-Zeichen ch entspricht.

Hinweis: Dieser Konstruktor ist nicht verfügbar, wenn „ QT_NO_CAST_FROM_ASCII “ oder „ QT_RESTRICTED_CAST_FROM_ASCII “ definiert ist.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

Siehe auch QT_NO_CAST_FROM_ASCII und QT_RESTRICTED_CAST_FROM_ASCII.

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

Erzeugt ein `QChar` für das Zeichen mit dem Unicode-Codepunkt ` code`.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein `QChar` für das Zeichen mit dem Unicode-Codepunkt ` code`.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktor-Argumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein QChar, das dem Wide-Zeichen „ ch “ entspricht.

Hinweis: Dieser Konstruktor ist nur unter Windows verfügbar.

Hinweis: Seit Qt 6.9 sind implizite Konvertierungen für diesen Konstruktor deaktiviert. Das bedeutet, dass er nur den Konstruktorargumenttyp akzeptiert und nicht alles, was implizit in diesen Typ konvertiert werden kann. Eine abwärtskompatible Lösung besteht darin, explizit in einen der unterstützten Argumenttypen der QChar-Konstruktoren zu konvertieren.

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

Erzeugt ein QChar für die Unicode-Zelle „ cell “ in Zeile „ row “.

Siehe auch ` cell()` und ` row()`.

[noexcept] QChar::Category QChar::category() const

Gibt die Kategorie des Charakters zurück.

[static noexcept] QChar::Category QChar::category(char32_t ucs4)

Gibt die Kategorie des durch ` ucs4` angegebenen, UCS-4-kodierten Zeichens zurück.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt die Zelle (das niedrigstwertige Byte) des Unicode-Zeichens zurück.

Siehe auch „ row()“.

[noexcept] unsigned char QChar::combiningClass() const

Gibt die im Unicode-Standard definierte Kombinationsklasse für das Zeichen zurück. Dies ist vor allem als Positionierungshinweis für an ein Basiszeichen angehängte Markierungen nützlich.

Die Qt-Text-Rendering-Engine nutzt diese Informationen, um nicht-abstandsgebende Zeichen korrekt um ein Basiszeichen herum zu positionieren.

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

Gibt die Kombinationsklasse für das durch ` ucs4` angegebene, UCS-4-kodierte Zeichen zurück, wie im Unicode-Standard definiert.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt die aktuellste unterstützte Unicode-Version zurück.

QString QChar::decomposition() const

Zerlegt ein Zeichen in seine Bestandteile. Gibt eine leere Zeichenkette zurück, wenn keine Zerlegung möglich ist.

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

Zerlegt das durch ` ucs4 ` angegebene, UCS-4-kodierte Zeichen in seine Bestandteile. Gibt eine leere Zeichenkette zurück, wenn keine Zerlegung möglich ist.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ ` uint ` entgegen.

Dies ist eine überladene Funktion.

[noexcept] QChar::Decomposition QChar::decompositionTag() const

Gibt das Tag zurück, das die Zusammensetzung des Zeichens definiert. Gibt „ QChar::NoDecomposition “ zurück, wenn keine Zerlegung vorliegt.

[static noexcept] QChar::Decomposition QChar::decompositionTag(char32_t ucs4)

Gibt das Tag zurück, das die Zusammensetzung des durch ` ucs4` angegebenen UCS-4-kodierten Zeichens definiert. Gibt ` QChar::NoDecomposition ` zurück, wenn keine Zerlegung vorliegt.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

[noexcept] int QChar::digitValue() const

Gibt den numerischen Wert der Ziffer zurück oder -1, wenn das Zeichen keine Ziffer ist.

[static noexcept] int QChar::digitValue(char32_t ucs4)

Gibt den numerischen Wert der Ziffer zurück, die durch das UCS-4-kodierte Zeichen ucs4 angegeben wird, oder -1, wenn das Zeichen keine Ziffer ist.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

[noexcept] QChar::Direction QChar::direction() const

Gibt die Richtung des Charakters zurück.

[static noexcept] QChar::Direction QChar::direction(char32_t ucs4)

Gibt die Richtung des durch „ ucs4 “ angegebenen, UCS-4-kodierten Zeichens zurück.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Konvertiert das Latin-1-Zeichen „ c “ in das entsprechende Zeichen „ QChar “. Dies ist vor allem für nicht internationalisierte Software nützlich.

Eine Alternative ist die Verwendung von ` QLatin1Char`.

Siehe auch toLatin1() und unicode().

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

Erstellt ein „ QChar “ aus dem UTF-16-Zeichen c.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` fromUcs4()`.

[static constexpr noexcept, since 6.0] auto QChar::fromUcs4(char32_t c)

Gibt eine anonyme Struktur zurück, die

  • ein Array vom Typ „ char16_t chars[2] “ enthält,
  • implizit in ein ` QStringView` konvertiert werden kann und
  • mit einer C++11-`for`-Schleife mit Bereichsangabe durchlaufen werden kann.

Wenn „ c “ Surrogate erfordert, enthält „ chars[0] “ das hohe Surrogate und „ chars[1] “ das niedrige Surrogate, und „ QStringView “ hat die Größe 2. Andernfalls enthält „ chars[0] “ „ c “ und „ chars[1] “ ist „ null “, und „ QStringView “ hat die Größe 1.

Dies ermöglicht eine einfache Verwendung des Ergebnisses:

QString s;
s += QChar::fromUcs4(ch);
for (char16_t c16 : QChar::fromUcs4(ch))
    use(c16);

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ fromUcs2()“ und „ requiresSurrogates()“.

[noexcept] bool QChar::hasMirrored() const

Gibt ` true ` zurück, wenn das Zeichen bei umgekehrter Textrichtung umgekehrt werden soll; andernfalls wird ` false` zurückgegeben.

Eine etwas schnellere Alternative zu (ch.mirroredChar() != ch).

Siehe auch mirroredChar().

[static noexcept] bool QChar::hasMirrored(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, in UCS-4 kodierte Zeichen bei einer Umkehrung der Textrichtung umgekehrt werden soll; andernfalls wird „ false “ zurückgegeben.

Eine etwas schnellere Entsprechung von (QChar::mirroredChar(ucs4) != ucs4).

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Siehe auch ` mirroredChar()`.

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

Gibt den oberen Surrogatteil eines UCS-4-kodierten Codepunkts zurück. Das Ergebnis ist undefiniert, wenn ucs4 kleiner als 0x10000 ist.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument „ uint “ entgegen und gab „ ushort “ zurück.

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

Gibt „ true “ zurück, wenn das Zeichen eine Dezimalziffer ist (Number_DecimalDigit); andernfalls wird „ false “ zurückgegeben.

Siehe auch isNumber().

[static constexpr noexcept] bool QChar::isDigit(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen eine Dezimalziffer ist (Number_DecimalDigit); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Siehe auch isNumber().

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

Gibt „ true “ zurück, wenn der „ QChar “ der obere Teil eines UTF-16-Surrogats ist (beispielsweise wenn sein Codepunkt im Bereich [0xd800..0xdbff] liegt); andernfalls „false“.

[static constexpr noexcept] bool QChar::isHighSurrogate(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen der obere Teil eines UTF-16-Surrogats ist (beispielsweise, wenn sein Codepunkt im Bereich [0xd800..0xdbff] liegt); andernfalls „false“.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn das Zeichen ein Buchstabe ist (Kategorien „Letter_*“); andernfalls wird „ false “ zurückgegeben.

[static constexpr noexcept] bool QChar::isLetter(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Buchstabe ist (Kategorien „Letter_*“); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn das Zeichen ein Buchstabe oder eine Ziffer ist (Kategorien „Letter_*“ oder „Number_*“); andernfalls wird „ false “ zurückgegeben.

[static constexpr noexcept] bool QChar::isLetterOrNumber(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Buchstabe oder eine Ziffer ist (Kategorien „Letter_*“ oder „Number_*“); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn der „ QChar “ der untere Teil eines UTF-16-Surrogats ist (beispielsweise wenn sein Codepunkt im Bereich [0xdc00..0xdfff] liegt); andernfalls „false“.

[static constexpr noexcept] bool QChar::isLowSurrogate(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen der untere Teil eines UTF-16-Surrogates ist (beispielsweise, wenn sein Codepunkt im Bereich [0xdc00..0xdfff] liegt); andernfalls „false“.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn das Zeichen ein Kleinbuchstabe ist; beispielsweise ist das Ergebnis von „ category()“ „ Letter_Lowercase “.

Siehe auch isUpper(), toLower() und toUpper().

[static constexpr noexcept] bool QChar::isLower(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Kleinbuchstabe ist; beispielsweise ist „ category()“ gleich „ Letter_Lowercase “.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Siehe auch isUpper(), toLower() und toUpper().

[noexcept] bool QChar::isMark() const

Gibt „ true “ zurück, wenn es sich bei dem Zeichen um eine Markierung handelt (Kategorien „Mark_*“); andernfalls wird „ false “ zurückgegeben.

Weitere Informationen zu Markierungen finden Sie unter QChar::Category.

[static noexcept] bool QChar::isMark(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Mark ist (Kategorien „Mark_*“); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn der „ QChar “ kein Zeichen ist; andernfalls „false“.

Unicode verfügt über eine bestimmte Anzahl von Codepunkten, die als „Nicht-Zeichen“ klassifiziert sind: Das heißt, sie können für interne Zwecke in Anwendungen verwendet werden, sind jedoch nicht für den Textaustausch geeignet. Dies sind die letzten beiden Einträge jeder Unicode-Ebene ([0xfffe..0xffff], [0x1fffe..0x1ffff] usw.) sowie die Einträge im Bereich [0xfdd0..0xfdef].

[static constexpr noexcept] bool QChar::isNonCharacter(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen kein Zeichen ist; andernfalls „false“.

Unicode verfügt über eine bestimmte Anzahl von Codepunkten, die als „Nicht-Zeichen“ klassifiziert sind: Das heißt, sie können für interne Zwecke in Anwendungen verwendet werden, sind jedoch nicht für den Textaustausch geeignet. Dies sind die letzten beiden Einträge jeder Unicode-Ebene ([0xfffe..0xffff], [0x1fffe..0x1ffff] usw.) sowie die Einträge im Bereich [0xfdd0..0xfdef].

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn es sich bei dem Zeichen um das Unicode-Zeichen 0x0000 („\0 “) handelt; andernfalls wird „ false “ zurückgegeben.

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

Gibt „ true “ zurück, wenn das Zeichen eine Zahl ist (Kategorien „Number_*“, nicht nur 0–9); andernfalls wird „ false “ zurückgegeben.

Siehe auch isDigit().

[static constexpr noexcept] bool QChar::isNumber(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen eine Zahl ist (Kategorien „Number_*“, nicht nur 0–9); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Siehe auch isDigit().

[noexcept] bool QChar::isPrint() const

Gibt „ true “ zurück, wenn es sich um ein druckbares Zeichen handelt; andernfalls wird „ false “ zurückgegeben. Dies betrifft alle Zeichen, die nicht zur Kategorie „ Other_*“ gehören.

Beachten Sie, dass dies keinen Hinweis darauf gibt, ob das Zeichen in einer bestimmten Schriftart verfügbar ist.

[static noexcept] bool QChar::isPrint(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein druckbares Zeichen ist; andernfalls wird „ false “ zurückgegeben. Dabei handelt es sich um jedes Zeichen, das nicht zur Kategorie „ Other_*“ gehört.

Beachten Sie, dass dies keinen Hinweis darauf gibt, ob das Zeichen in einer bestimmten Schriftart verfügbar ist.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

[noexcept] bool QChar::isPunct() const

Gibt „ true “ zurück, wenn es sich bei dem Zeichen um ein Satzzeichen handelt (Kategorien „Punctuation_*“); andernfalls wird „ false “ zurückgegeben.

[static noexcept] bool QChar::isPunct(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Satzzeichen ist (Kategorien „Punctuation_*“); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn das Zeichen ein Trennzeichen ist (Kategorien „Separator_*“ oder bestimmte Codepunkte aus der Kategorie „ Other_Control “); andernfalls wird „ false “ zurückgegeben.

[static constexpr noexcept] bool QChar::isSpace(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Trennzeichen ist (Kategorien „Separator_*“ oder bestimmte Codepunkte aus der Kategorie „ Other_Control “); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn der „ QChar “ einen Codepunkt enthält, der sich entweder im oberen oder im unteren Teil des UTF-16-Surrogatbereichs befindet (beispielsweise wenn sein Codepunkt im Bereich [0xd800..0xdfff] liegt); andernfalls „false“.

[static constexpr noexcept] bool QChar::isSurrogate(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen einen Codepunkt enthält, der entweder im oberen oder im unteren Teil des UTF-16-Surrogatbereichs liegt (beispielsweise wenn sein Codepunkt im Bereich [0xd800..0xdfff] liegt); andernfalls „false“.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

[noexcept] bool QChar::isSymbol() const

Gibt „ true “ zurück, wenn das Zeichen ein Symbol ist (Kategorien „Symbol_*“); andernfalls wird „ false “ zurückgegeben.

[static noexcept] bool QChar::isSymbol(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Symbol ist (Kategorien „Symbol_*“); andernfalls wird „ false “ zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt „ true “ zurück, wenn es sich bei dem Zeichen um einen Groß- und Kleinbuchstaben handelt; beispielsweise ergibt „ category “ () das Ergebnis „ Letter_Titlecase “.

Siehe auch „ isLower()“, „ toUpper()“, „ toLower()“ und „ toTitleCase()“.

[static constexpr noexcept] bool QChar::isTitleCase(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Groß- und Kleinbuchstabe ist; beispielsweise ist „ category()“ gleich „ Letter_Titlecase “.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Siehe auch isLower(), toUpper(), toLower() und toTitleCase().

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

Gibt „ true “ zurück, wenn es sich bei dem Zeichen um einen Großbuchstaben handelt; beispielsweise ist das Ergebnis von „ category()“ „ Letter_Uppercase “.

Siehe auch isLower(), toUpper() und toLower().

[static constexpr noexcept] bool QChar::isUpper(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen ein Großbuchstabe ist; beispielsweise ist das Ergebnis von „ category()“ „ Letter_Uppercase “.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Siehe auch isLower(), toUpper() und toLower().

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

Gibt Informationen zu den Attributen des Verbindungstyps des Zeichens zurück (erforderlich für bestimmte Sprachen wie Arabisch oder Syrisch).

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

Gibt Informationen zu den Attributen des Verbindungstyps des durch „ ucs4 “ angegebenen UCS-4-kodierten Zeichens zurück (erforderlich für bestimmte Sprachen wie Arabisch oder Syrisch).

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Gibt den unteren Surrogatteil eines UCS-4-kodierten Codepunkts zurück. Das Ergebnis ist undefiniert, wenn ucs4 kleiner als 0x10000 ist.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen und gab „ ushort “ zurück.

[noexcept] QChar QChar::mirroredChar() const

Gibt das gespiegelte Zeichen zurück, wenn es sich um ein gespiegeltes Zeichen handelt; andernfalls wird das Zeichen selbst zurückgegeben.

Siehe auch „ hasMirrored()“.

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

Gibt das gespiegelte Zeichen zurück, wenn das durch ` ucs4 ` angegebene, UCS-4-kodierte Zeichen ein gespiegeltes Zeichen ist; andernfalls wird das Zeichen selbst zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen und gab „ uint “ zurück.

Dies ist eine überladene Funktion.

Siehe auch hasMirrored().

[static constexpr noexcept] bool QChar::requiresSurrogates(char32_t ucs4)

Gibt „ true “ zurück, wenn das durch „ ucs4 “ angegebene, UCS-4-kodierte Zeichen in den oberen und unteren Teil eines UTF-16-Surrogates aufgeteilt werden kann (beispielsweise, wenn sein Codepunkt größer oder gleich 0x10000 ist); andernfalls „false“.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

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

Gibt die Zeile (das höchstwertige Byte) des Unicode-Zeichens zurück.

Siehe auch „ cell()“.

[noexcept] QChar::Script QChar::script() const

Gibt den Wert der Unicode-Eigenschaft „script“ für dieses Zeichen zurück.

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

Gibt den Wert der Unicode-Skript-Eigenschaft für das angegebene Zeichen in seiner UCS-4-kodierten Form als „ ucs4 “ zurück.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

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

Konvertiert ein UTF-16-Surrogatpaar mit den angegebenen Werten für „ high “ und „ low “ in seinen UCS-4-kodierten Codepunkt.

Hinweis: Vor Qt 6 nahm diese Funktion „ ushort “-Argumente entgegen und gab „ uint “ zurück.

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

Konvertiert ein UTF-16-Surrogatpaar (high, low) in seinen UCS-4-kodierten Codepunkt.

Hinweis: Vor Qt 6 gab diese Funktion „ uint “ zurück.

Dies ist eine überladene Funktion.

[noexcept] QChar QChar::toCaseFolded() const

Gibt das groß-/kleinschreibungsunabhängige Äquivalent des Zeichens zurück. Bei den meisten Unicode-Zeichen entspricht dies der Funktion „ toLower()“.

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

Gibt das „Case-Folded“-Äquivalent des durch ucs4 angegebenen, UCS-4-kodierten Zeichens zurück. Für die meisten Unicode-Zeichen entspricht dies dem Ergebnis von toLower().

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen und gab „ uint “ zurück.

Dies ist eine überladene Funktion.

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

Gibt das Latin-1-Zeichen zurück, das dem „ QChar “ entspricht, oder 0. Dies ist vor allem für nicht internationalisierte Software nützlich.

Hinweis: Es ist nicht möglich, ein Nicht-Latin-1-Zeichen von einem Latin-1-0-Zeichen (NUL) zu unterscheiden. Verwenden Sie vorzugsweise „ unicode()“, da diese Funktion diese Mehrdeutigkeit nicht aufweist.

Siehe auch ` unicode()`.

[noexcept] QChar QChar::toLower() const

Gibt die Entsprechung in Kleinbuchstaben zurück, wenn das Zeichen ein Großbuchstabe oder ein Titelbuchstabe ist; andernfalls wird das Zeichen selbst zurückgegeben.

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

Gibt das Kleinbuchstabenäquivalent des durch ` ucs4 ` angegebenen, UCS-4-kodierten Zeichens zurück, sofern es sich um einen Großbuchstaben oder einen Titelbuchstaben handelt; andernfalls wird das Zeichen selbst zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen und gab „ uint “ zurück.

Dies ist eine überladene Funktion.

[noexcept] QChar QChar::toTitleCase() const

Gibt die entsprechende Schreibweise in Groß- und Kleinschreibung zurück, wenn das Zeichen ein Klein- oder Großbuchstabe ist; andernfalls wird das Zeichen selbst zurückgegeben.

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

Gibt die Entsprechung in Groß-/Kleinschreibung des durch ucs4 angegebenen, UCS-4-kodierten Zeichens zurück, sofern es sich um ein Klein- oder Großbuchstabenzeichen handelt; andernfalls wird das Zeichen selbst zurückgegeben.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen und gab „ uint “ zurück.

Dies ist eine überladene Funktion.

[noexcept] QChar QChar::toUpper() const

Gibt die Großbuchstaben-Entsprechung zurück, wenn das Zeichen ein Kleinbuchstabe oder ein Titelbuchstabe ist; andernfalls wird das Zeichen selbst zurückgegeben.

Hinweis: Diese Funktion gibt in dem seltenen Fall, dass die Großbuchstabenform des Zeichens zwei oder mehr Zeichen benötigt, ebenfalls das ursprüngliche Zeichen zurück.

Siehe auch „ QString::toUpper()“.

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

Gibt das Großbuchstabenäquivalent des durch „ ucs4 “ angegebenen, UCS-4-kodierten Zeichens zurück, sofern es sich um einen Kleinbuchstaben oder einen Titelbuchstaben handelt; andernfalls wird das Zeichen selbst zurückgegeben.

Hinweis: Diese Funktion gibt auch das ursprüngliche Zeichen zurück, falls die Großbuchstabenform des Zeichens in seltenen Fällen zwei oder mehr Zeichen benötigt.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen und gab „ uint “ zurück.

Dies ist eine überladene Funktion.

Siehe auch ` QString::toUpper()`.

[constexpr noexcept] char16_t &QChar::unicode()

Gibt eine Referenz auf den numerischen Unicode-Wert von „ QChar “ zurück.

[constexpr noexcept] char16_t QChar::unicode() const

Gibt den numerischen Unicode-Wert von „ QChar “ zurück.

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

Gibt die Unicode-Version zurück, in der dieses Zeichen eingeführt wurde.

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

Gibt die Unicode-Version zurück, in der das angegebene Zeichen in seiner UCS-4-kodierten Form als „ ucs4 “ eingeführt wurde.

Hinweis: Vor Qt 6 nahm diese Funktion ein Argument vom Typ „ uint “ entgegen.

Dies ist eine überladene Funktion.

Verwandte Nicht-Mitglieder

[constexpr noexcept] bool operator!=(const QChar &c1, const QChar &c2)

Gibt „ true “ zurück, wenn „ c1 “ und „ c2 “ nicht dasselbe Unicode-Zeichen sind; andernfalls wird „ false “ zurückgegeben.

[constexpr noexcept] bool operator<(const QChar &c1, const QChar &c2)

Gibt „ true “ zurück, wenn der numerische Unicode-Wert von „ c1 “ kleiner ist als der von „ c2 “; andernfalls wird „ false “ zurückgegeben.

QDataStream &operator<<(QDataStream &out, QChar chr)

Schreibt das Zeichen „ chr “ in den Stream „ out “.

Siehe auch „Serialisierung vonQt-Datentypen“.

[constexpr noexcept] bool operator<=(const QChar &c1, const QChar &c2)

Gibt „ true “ zurück, wenn der numerische Unicode-Wert von „ c1 “ kleiner oder gleich dem von „ c2 “ ist; andernfalls wird „ false “ zurückgegeben.

[constexpr noexcept] bool operator==(const QChar &c1, const QChar &c2)

Gibt „ true “ zurück, wenn „ c1 “ und „ c2 “ dasselbe Unicode-Zeichen sind; andernfalls wird „ false “ zurückgegeben.

[constexpr noexcept] bool operator>(const QChar &c1, const QChar &c2)

Gibt „ true “ zurück, wenn der numerische Unicode-Wert von „ c1 “ größer ist als der von „ c2 “; andernfalls wird „ false “ zurückgegeben.

[constexpr noexcept] bool operator>=(const QChar &c1, const QChar &c2)

Gibt „ true “ zurück, wenn der numerische Unicode-Wert von „ c1 “ größer oder gleich dem von „ c2 “ ist; andernfalls wird „ false “ zurückgegeben.

QDataStream &operator>>(QDataStream &in, QChar &chr)

Liest ein Zeichen aus dem Stream „ in “ in die Variable „ chr “ ein.

Siehe auch „Serialisierung vonQt-Datentypen“.

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