QChar Class

QChar クラスは、16 ビットの Unicode 文字を提供します。詳細...

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

このクラスは強く比較可能です。

このクラスは char16_t,QString,QStringView,QLatin1StringView,QUtf8StringView強く比較可能です。

このクラスは、const char *,QByteArray, およびQByteArrayView強く比較可能です。

バイト配列の内容は utf-8 として解釈されます。

注意:このクラスの関数はすべてリエントラントです。

パブリック型

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 }

パブリック関数

QChar()
QChar(QChar::SpecialCharacter ch)
QChar(QLatin1Char ch)
QChar(char ch)
QChar(char16_t ch)
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

静的パブリック・メンバ

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)

詳細説明

Qt では、Unicode 文字はマークアップや構造を持たない 16 ビットの実体です。このクラスはそのような実体を表します。軽量なので、どこでも使えます。ほとんどのコンパイラは、これをunsigned short のように扱います。

QCharは、他のフォーマットとの変換、合成されたUnicodeから分解されたUnicodeへの変換、比較や大文字と小文字の変換など、あらゆるテスト/分類関数を提供します。

分類関数は、標準C++ヘッダ<cctype>(旧<ctype.h>)にあるような関数を含みますが、ASCII範囲だけでなく、Unicode文字の全範囲で動作します。これらの関数はすべて、文字が特定のタイプの文字であれば真を返し、そうでなければ偽を返します。これらの分類関数は、isNull() (文字が「'˶0'」ならtrue を返す)、isPrint() (文字が空白を含むあらゆる種類の印字可能文字なら真)、isPunct() (あらゆる種類の句読点)、isMark() (Unicode マーク)、isLetter() (文字)、isNumber() (0-9 だけでなくあらゆる種類の数値文字)、isLetterOrNumber() およびisDigit() (10進数)です。これらはすべてcategory() のラッパーで、Unicode で定義された各文字のカテゴリを返します。これらの中には、派生プロパティも計算するものもあります(たとえば、isSpace() は、その文字がカテゴリ Separator_* の場合、またはOther_Control カテゴリからの例外コードポイントの場合、true を返します)。

QChar には、この文字の「自然な」書き順を示すdirection() もあります。joiningType ()関数は、その文字がどのように隣の文字と結合するかを示します(主にアラビア語やシリア語に必要です)。最後にhasMirrored ()関数は、その文字が「不自然な」書き方で印刷されるときにミラーリングが必要かどうかを示します。

構成されたUnicode文字(ring のような)は、decomposition ()を使うことで、分解されたUnicode("a "の後に "ring above "が続く)に変換することができます。

ユニコードでは、比較は必ずしも可能ではなく、大文字小文字の変換はせいぜい非常に困難です。operator==()とその仲間は、純粋に文字のUnicodeの数値(コードポイント)に基づいて比較を行い、toUpper()とtoLower()は、文字が明確に定義された大文字/小文字の等価物を持つ場合に大文字/小文字の変換を行います。ロケール依存の比較にはQString::localeAwareCompare() を使用する。

変換関数には、unicode() (スカラーへ)、toLatin1() (スカラーへ、ただし非ラテン1文字はすべて0に変換)、row() (Unicode行を与える)、cell() (Unicodeセルを与える)、digitValue() (多数の数字文字のいずれかの整数値を与える)、および多数のコンストラクタがあります。

QChar にはコンストラクタとキャスト演算子が用意されており、従来の 8 ビットcharとの変換が簡単に行えます。QT_NO_CAST_FROM_ASCIIQT_NO_CAST_TO_ASCIIQString のドキュメントで説明されているように定義した場合、8 ビットchar から QChar を構築するには、明示的にfromLatin1() を呼び出すか、QLatin1Char を使用する必要があり、8 ビット値を取得するにはtoLatin1() を呼び出す必要があります。

Qt 6.0 以降、ほとんどの QChar コンストラクタはexplicit です。これは、積分型と文字列を誤って混在させたときの危険な間違いを避けるためです。

詳細については、"Unicode 文字データベースについて" を参照してください。

Unicode,QString,QLatin1Charも参照してください

メンバ型文書

enum QChar::Category

この列挙型は、Unicode 文字カテゴリをマッピングします。

以下の文字は Unicode で規範となっています:

定数説明
QChar::Mark_NonSpacing0Unicode クラス名 Mn
QChar::Mark_SpacingCombining1Unicode クラス名 Mc
QChar::Mark_Enclosing2ユニコード・クラス名 Me
QChar::Number_DecimalDigit3ユニコード・クラス名 Nd
QChar::Number_Letter4ユニコード・クラス名 Nl
QChar::Number_Other5ユニコードクラス名 No
QChar::Separator_Space6ユニコードクラス名 Zs
QChar::Separator_Line7ユニコードクラス名 Zl
QChar::Separator_Paragraph8ユニコードクラス名 Zp
QChar::Other_Control9ユニコードクラス名 Cc
QChar::Other_Format10ユニコードクラス名 Cf
QChar::Other_Surrogate11ユニコードクラス名 Cs
QChar::Other_PrivateUse12ユニコードクラス名 Co
QChar::Other_NotAssigned13Unicode クラス名 Cn

以下のカテゴリは、Unicodeでは情報的です:

定数説明
QChar::Letter_Uppercase14ユニコードクラス名 Lu
QChar::Letter_Lowercase15ユニコード・クラス名 Ll
QChar::Letter_Titlecase16ユニコード・クラス名 Lt
QChar::Letter_Modifier17ユニコードクラス名 Lm
QChar::Letter_Other18ユニコードクラス名 Lo
QChar::Punctuation_Connector19ユニコードクラス名 Pc
QChar::Punctuation_Dash20ユニコードクラス名 Pd
QChar::Punctuation_Open21ユニコードクラス名 Ps
QChar::Punctuation_Close22ユニコードクラス名 Pe
QChar::Punctuation_InitialQuote23ユニコードクラス名 Pi
QChar::Punctuation_FinalQuote24ユニコードクラス名 Pf
QChar::Punctuation_Other25ユニコードクラス名 Po
QChar::Symbol_Math26ユニコードクラス名 Sm
QChar::Symbol_Currency27ユニコードクラス名 Sc
QChar::Symbol_Modifier28ユニコードクラス名 Sk
QChar::Symbol_Other29ユニコード・クラス名 So

category()も参照のこと

enum QChar::Decomposition

この列挙型は Unicode 分解属性を定義します。値の説明についてはUnicode標準を参照してください。

定数
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

decomposition()も参照

enum QChar::Direction

この enum 型は Unicode の方向属性を定義する。値の説明についてはUnicode標準を参照してください。

C/C++の命名規則に準拠するために、Unicode Standardで使用されるコードの前に "Dir "が付加されます。

定数
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

direction()も参照してください

enum QChar::JoiningType

5.3 以降

この列挙型は、Unicodeの結合型属性を定義します。値の説明についてはUnicode標準を参照してください。

C/C++の命名規則に従うために、"Joining_"がUnicode Standardで使用されているコードの前に付加されています。

定数
QChar::Joining_None0
QChar::Joining_Causing1
QChar::Joining_Dual2
QChar::Joining_Right3
QChar::Joining_Left4
QChar::Joining_Transparent5

joiningType()も参照してください

enum QChar::Script

こ の列挙型は、 Unicode 用字系プ ロ パテ ィ 値を定義 し ます。

Unicode script プロパティ値の詳細については、Unicode Standard Annex #24 を参照してください。

C/C++の命名規則に準拠するため、Unicode Standardで使用されるコードの前に "Script_"が付加されています。

定数説明
QChar::Script_Unknown0未割り当て ・ 私用 ・ 非文字 ・ サ ロ ゲー ト コ ー ド 点。
QChar::Script_Inherited1複数のキ ャ ラ ク タ で用い ら れ る キ ャ ラ ク タ であ り 、 先行キ ャ ラ ク タ か ら キ ャ ラ ク タ を継承す る キ ャ ラ ク タ 。こ れ ら には、 スペーシングなしマーク、囲みマーク、幅ゼロの結合子/非結合子キ ャ ラ ク タ が含まれます。
QChar::Script_Common2複数のスクリプトで使用でき、直前のキャラクタからスクリプトを継承しないキャラクタの場合。
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_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_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_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_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_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_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_SylotiNagri59
QChar::Script_Syriac9
QChar::Script_Tagalog42
QChar::Script_Tagbanwa45
QChar::Script_TaiLe48
QChar::Script_TaiTham78
QChar::Script_TaiViet79
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_Toto (since Qt 6.3)160
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

script()も参照のこと

enum QChar::SpecialCharacter

定数説明
QChar::Null0x0000この値を持つQChar isNull ()。
QChar::Tabulation0x0009文字タブ。
QChar::LineFeed0x000a
QChar::FormFeed0x000c
QChar::CarriageReturn0x000d
QChar::Space0x0020
QChar::Nbsp0x00a0非改行スペース。
QChar::SoftHyphen0x00ad
QChar::ReplacementCharacter0xfffdあるコードポイントに対応するグリフがフォントにない場合に表示される文字。特殊なクエスチョンマーク文字がよく使われる。入力デー タ が Unicode で表現で き ない と き に コ ーデ ッ ク は こ の コ ー ド ポ イ ン ト を用います。
QChar::ObjectReplacementCharacter0xfffc画像などのオブジェクトが表示できない場合に、そのオブジェクトを表現するのに使われます。
QChar::ByteOrderMark0xfeff
QChar::ByteOrderSwapped0xfffe
QChar::ParagraphSeparator0x2029
QChar::LineSeparator0x2028
QChar::VisualTabCharacter (since Qt 6.2)0x2192表組みを横向きの矢印で表現する場合に使用します。
QChar::LastValidCodePoint0x10ffff

enum QChar::UnicodeVersion

ある文字がユニコード規格のどのバージョンで導入されたかを指定します。

定数説明
QChar::Unicode_1_11バージョン 1.1
QChar::Unicode_2_02バージョン 2.0
QChar::Unicode_2_1_23バージョン2.1.2
QChar::Unicode_3_04バージョン3.0
QChar::Unicode_3_15バージョン3.1
QChar::Unicode_3_26バージョン3.2
QChar::Unicode_4_07バージョン4.0
QChar::Unicode_4_18バージョン4.1
QChar::Unicode_5_09バージョン5.0
QChar::Unicode_5_110バージョン5.1
QChar::Unicode_5_211バージョン5.2
QChar::Unicode_6_012バージョン6.0
QChar::Unicode_6_113バージョン6.1
QChar::Unicode_6_214バージョン6.2
QChar::Unicode_6_3 (since Qt 5.3)15バージョン6.3
QChar::Unicode_7_0 (since Qt 5.5)16バージョン7.0
QChar::Unicode_8_0 (since Qt 5.6)17バージョン8.0
QChar::Unicode_9_0 (since Qt 5.11)18バージョン9.0
QChar::Unicode_10_0 (since Qt 5.11)19バージョン10.0
QChar::Unicode_11_0 (since Qt 5.15)20バージョン11.0
QChar::Unicode_12_0 (since Qt 5.15)21バージョン12.0
QChar::Unicode_12_1 (since Qt 5.15)22バージョン12.1
QChar::Unicode_13_0 (since Qt 5.15)23バージョン13.0
QChar::Unicode_14_0 (since Qt 6.3)24バージョン14.0
QChar::Unicode_15_0 (since Qt 6.5)25バージョン15.0
QChar::Unicode_15_1 (since Qt 6.8)26バージョン 15.1
QChar::Unicode_Unassigned0Unicode バージョン 8.0 では、この値はどの文字にも割り当てられていません。

unicodeVersion() およびcurrentUnicodeVersion()も参照のこと

メンバ関数 ドキュメント

[constexpr noexcept] QChar::QChar()

null QChar ('¬0')を構築します。

isNull() も参照して ください。

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

定義済みの文字値ch に対応する QChar を構築します。

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

ASCII/Latin-1 文字ch に対応する QChar を構築します。

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

ASCII/Latin-1 文字ch に対応する QChar を構築します。

注意: QT_NO_CAST_FROM_ASCII が定義されている場合、このコンストラクタは使用できません。

QT_NO_CAST_FROM_ASCIIも参照してください

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

UTF-16 文字に対応する QChar を構築しますch.

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

Unicode コードポイントを持つ文字に対応する QChar を構築しますcode.

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

Unicode コードポイントcode を持つ文字に対応する QChar を構築します。

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

ASCII/Latin-1 文字に対応する QChar を構築しますch

注: QT_NO_CAST_FROM_ASCII またはQT_RESTRICTED_CAST_FROM_ASCII が定義されている場合、このコンストラクタは使用できません。

QT_NO_CAST_FROM_ASCII およびQT_RESTRICTED_CAST_FROM_ASCIIも参照してください

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

Unicode コードポイントcode を持つ文字に対応する QChar を構築します。

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

Unicode コードポイントcode を持つ文字に対応する QChar を構築します。

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

ワイド文字ch に対応する QChar を構築します。

注意: このコンストラクタは Windows でのみ使用できます。

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

row 行の Unicode セルcell に対応する QChar を構築します。

cell() およびrow()も参照して ください。

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

文字のカテゴリを返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字のカテゴリを返します。

注: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

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

Unicode 文字のセル(最下位バイト)を返します。

row()も参照してください

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

Unicode 規格で定義 さ れてい る 、 そのキ ャ ラ ク タ の結合ク ラ ス を返 し ます。これは主に、ベースキャラクタに付加されたマークの位置決めヒントとして有用です。

Qt テキストレンダリングエンジンは、この情報を使用して、ベースキャラクタの周囲にノンスペーシングマークを正しく配置します。

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

これはオーバーロードされた関数です。

Unicode 標準で定義されているように、ucs4 で指定された UCS-4 エンコード文字の結合クラスを返します。

注: Qt 6 より前のバージョンでは、この関数はuint 引数をとりました。

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

サポートされている最新の Unicode バージョンを返します。

QString QChar::decomposition() const

文字を構成要素に分解します。分解が存在しない場合は空文字列を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字を、その構成要素に分解します。分解が存在しない場合は空文字列を返します。

注意: Qt 6 以前では、この関数はuint 引数をとりました。

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

文字の構成を定義するタグを返します。分解が存在しない場合はQChar::NoDecomposition を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字の構成を定義するタグを返します。分解が存在しない場合はQChar::NoDecomposition を返します。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

[noexcept] int QChar::digitValue() const

桁の数値を返し、文字が桁でない場合は -1 を返します。

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

これはオーバーロードされた関数です。

UCS-4 エンコードされた文字ucs4 で指定された桁の数値、またはその文字が桁でない場合は -1 を返します。

注: Qt 6 より前のバージョンでは、この関数はuint の引数を取っていました。

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

文字の方向を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字の方向を返します。

注意: Qt 6 以前では、この関数はuint 引数をとりました。

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

Latin-1 文字c を同等のQChar に変換します。これは主に非国際化ソフトウェアに役立ちます。

別の方法として、QLatin1Char を使うこともできます。

toLatin1() およびunicode()も参照して ください。

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

UTF-16 文字c からQChar を構築します。

この関数は Qt 6.0 で導入されました。

fromUcs4()も参照して ください。

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

を含む匿名構造体を返します。

  • char16_t chars[2] を返します、
  • 暗黙的にQStringView に変換できます。
  • C++11 の範囲付き for ループで反復処理されます。

c にサロゲートが必要な場合、chars[0] に高位サロゲート、chars[1] に低位サロゲートが含まれ、QStringView のサイズは 2 です。そうでない場合、chars[0]c を含み、chars[1]null であり、QStringView はサイズ1である。

これにより、結果を簡単に使うことができます:

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

この関数はQt 6.0で導入されました。

fromUcs2() およびrequiresSurrogates()も参照してください

[noexcept] bool QChar::hasMirrored() const

テキストの方向が反転している場合、その文字が反転されるべきであればtrue を返し、そうでなければfalse を返します。

(ch.mirroredChar() != ch) と少し高速です。

mirroredChar()も参照

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

これはオーバーロードされた関数である。

ucs4 で指定されたUCS-4エンコード文字が、 テキストの向きが反転している場合に反転されるべきであればtrue を返し、そうでなければfalse を返す。

QChar::mirroredChar(ucs4) != ucs4) と少し高速です。

注意: Qt 6 以前では、この関数はuint の引数をとっていました。

mirroredChar()も参照してください

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

UCS-4 エンコードされたコードポイントの上位サロゲート部分を返します。ucs4 が 0x10000 より小さい場合、返される結果は未定義です。

注意: Qt 6 以前では、この関数はuint 引数を取り、ushort を返していました。

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

文字が 10 進数 (Number_DecimalDigit) の場合はtrue を返し、それ以外の場合はfalse を返します。

isNumber()も参照してください

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

これはオーバーロードされた関数です。

ucs4 で指定されたUCS-4エンコード文字が10進数であればtrue を返し(Number_DecimalDigit )、そうでなければfalse を返す。

注意: Qt 6以前では、この関数はuint

isNumber()も参照してください

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

QChar が UTF16 サロゲートの上位部分である場合(例えばコードポイントが [0xd800..0xdbff] の範囲にある場合)にはtrue を返し、そうでない場合は false を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が UTF16 サロゲートの上位部分である場合(例えば、そのコードポイントが [0xd800..0xdbff] の範囲にある場合)にはtrue を返し、そうでない場合は false を返します。

注意: Qt 6 以前では、この関数はuint 引数をとりました。

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

文字が文字(Letter_*カテゴリ)の場合はtrue を返し、そうでない場合はfalse を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が文字 (Letter_* categories) である場合はtrue を返し、そうでない場合はfalse を返します。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

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

文字が文字または数字(Letter_* または Number_* カテゴリ)の場合はtrue を返し、それ以外の場合はfalse を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が文字または数字(Letter_* または Number_* カテゴリ)の場合はtrue を返し、それ以外の場合はfalse を返します。

注意: Qt 6 以前では、この関数はuint を引数にとりました。

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

QChar が UTF16 サロゲートの下位部分である場合(例えば、そのコードポイントが [0xdc00..0xdfff] の範囲にある場合)はtrue を返し、そうでない場合は false を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が UTF16 サロゲートの下位部分である場合(例えば、そのコードポイントが [0xdc00..0xdfff] の範囲にある場合)にはtrue を返し、そうでない場合は false を返します。

注意: Qt 6 以前では、この関数はuint 引数をとりました。

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

文字が小文字の場合はtrue を返し、例えばcategory() はLetter_Lowercase となります。

isUpper(),toLower(),toUpper()も参照してください

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が小文字の場合、true を返します。例えば、category() はLetter_Lowercase です。

注意: Qt 6 以前では、この関数はuint を引数にとりました。

isUpper()、toLower()、toUpper()も参照してください

[noexcept] bool QChar::isMark() const

文字がマーク(Mark_* カテゴリ)の場合はtrue を返し、そうでない場合はfalse を返します。

マークに関する詳細はQChar::Category を参照してください。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字がマーク(Mark_* categories)である場合はtrue を返し、そうでない場合はfalse を返します。

注意: Qt 6 以前では、この関数はuint を引数にとりました。

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

QChar が非文字の場合はtrue を返し、そうでない場合は false を返します。

Unicodeには「非文字」として分類されるコードポイントがいくつかあります:つまり、アプリケーションの内部目的には使用できますが、テキスト交換には使用できません。それらは、各Unicode Planeの最後の2つのエントリ([0xfffe..0xffff]、[0x1fffe..0x1ffff]など)、および範囲[0xfdd0..0xfdef]のエントリです。

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

これはオーバーロードされた関数である。

ucs4 、指定されたUCS-4エンコード文字が非文字の場合はtrue 、そうでない場合はfalseを返します。

Unicodeには、「非文字」として分類されるコードポイントがいくつかあります:つまり、アプリケーションの内部目的には使えますが、テキスト交換には使えません。それらは、各 Unicode Plane の最後の 2 つのエントリ ([0xfffe..0xffff]、[0x1fffe..0x1ffff] など)、および範囲 [0xfdd0..0xfdef] のエントリです。

注意: Qt 6以前では、この関数はuint

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

文字が Unicode 文字 0x0000 (' \0') の場合はtrue を返し、そうでない場合はfalse を返します。

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

文字が数字(Number_* カテゴリ、0-9 だけではない)の場合はtrue を返し、それ以外の場合はfalse を返します。

isDigit()も参照してください

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコードされた文字が数字 (0-9 だけではない Number_* カテゴリ) の場合はtrue を返し、それ以外の場合はfalse を返します。

注意: Qt 6 以前では、この関数はuint の引数を取っていました。

isDigit()も参照してください

[noexcept] bool QChar::isPrint() const

文字が印刷可能な文字の場合はtrue を返し、そうでない場合はfalse を返します。これは、カテゴリOther_* 以外の文字です。

これは、その文字が特定のフォントで利用可能かどうかを示すものではないことに注意してください。

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

これはオーバーロードされた関数です。

ucs4 で指定されたUCS-4エンコード文字が印字可能文字である場合はtrue を返し、そうでない場合はfalse を返します。こ れは、 カ テ ゴ リOther_* 以外の任意のキ ャ ラ ク タ です。

これは、その文字が特定のフォントで利用可能かどうかを示すものではないことに注意してください。

注意: Qt 6 より前のバージョンでは、この関数はuint 引数をとりました。

[noexcept] bool QChar::isPunct() const

文字が句読点(Punctuation_* カテゴリ)の場合はtrue を返し、そうでない場合はfalse を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が句読点(Punctuation_* categories)である場合はtrue を返し、そうでない場合はfalse を返します。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

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

文字が区切り文字(Separator_* カテゴリまたはOther_Control カテゴリの特定のコードポイント)である場合はtrue を返し、そうでない場合はfalse を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字がセパレータ文字(Separator_* カテゴリまたはOther_Control カテゴリの特定のコードポイント)である場合はtrue を返し、そうでない場合はfalse を返します。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

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

QChar が UTF-16 サロゲート範囲の上位または下位にあるコードポイントを含む場合(例えば、そのコードポイントが範囲 [0xd800..0xdfff] にある場合)にはtrue を返し、そうでない場合は false を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコードされた文字が、UTF-16 サロゲート範囲の高域または低域にあるコードポイントを含む場合(例えば、そのコードポイントが範囲 [0xd800..0xdfff] にある場合)にはtrue を返し、そうでない場合は false を返します。

注意: Qt 6 以前では、この関数はuint の引数を取っていました。

[noexcept] bool QChar::isSymbol() const

文字がシンボル(Symbol_* カテゴリ)の場合はtrue を返し、そうでない場合はfalse を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコードされた文字がシンボル (Symbol_* categories) であればtrue を返し、そうでなければfalse を返します。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

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

true 例えばcategory() はLetter_Titlecase です。

isLower(),toUpper(),toLower(),toTitleCase()も参照してください

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字がタイトルケース文字である場合、true を返します。例えば、category() はLetter_Titlecase です。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

isLower(),toUpper(),toLower(),toTitleCase()も参照してください

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

文字が大文字の場合はtrue を返します。例えばcategory() はLetter_Uppercase です。

isLower()、toUpper()、toLower()も参照

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が大文字の場合、true を返します。例えば、category() はLetter_Uppercase です。

注意: Qt 6 以前では、この関数はuint の引数をとりました。

isLower()、toUpper()、toLower()も参照してください

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

文字の結合型属性に関する情報を返します(アラビア語やシリア語などの特定の言語で必要です)。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字の結合タイプ属性に関する情報を返します(アラビア語やシリア語などの特定の言語で必要です)。

注意: Qt 6以前では、この関数はuint 引数をとりました。

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

UCS-4 エンコードされたコードポイントの低サロゲート部分を返します。ucs4 が 0x10000 より小さい場合、返される結果は未定義です。

注意: Qt 6 以前では、この関数はuint 引数を取り、ushort を返していました。

[noexcept] QChar QChar::mirroredChar() const

この文字がミラー文字である場合はミラー文字を返し、そうでない場合は文字そのものを返します。

hasMirrored()も参照してください

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字がミラーされた文字である場合、ミラーされた文字を返します。そうでない場合は、文字そのものを返します。

注意: Qt 6 以前では、この関数はuint 引数を取り、uint を返していました。

hasMirrored()も参照してください

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

ucs4 で指定された UCS-4 エンコード文字が、UTF16 サロゲートの上位部分と下位部分に分割できる場合 (例えば、コードポイントが 0x10000 以上の場合) にはtrue を返し、そうでない場合には false を返します。

注意: Qt 6 より前のバージョンでは、この関数はuint 引数をとりました。

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

Unicode 文字の行(最上位バイト)を返します。

cell()も参照してください

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

この文字の Unicode スクリプト・プロパティ値を返します。

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

これはオーバーロードされた関数です。

UCS-4 エンコード形式で指定された文字の Unicode スクリプト・プロパティ値をucs4 として返します。

注意: Qt 6 以前では、この関数はuint 引数をとりました。

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

与えられたhighlow の値を持つ UTF16 サロゲートペアを、UCS-4 エンコードされたコードポイントに変換します。

注意: Qt 6 以前では、この関数はushort 引数を取り、uint を返していました。

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

これはオーバーロードされた関数です。

UTF16 サロゲートペア (high,low) を UCS-4 エンコードされたコードポイントに変換します。

注意: Qt 6 以前では、この関数はuint を返していました。

[noexcept] QChar QChar::toCaseFolded() const

大文字小文字を区別した文字を返します。ほとんどの Unicode 文字では、これはtoLower() と同じです。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字の大文字小文字を区別した等価物を返します。ほとんどの Unicode 文字では、これはtoLower() と同じです。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとり、uint を返していました。

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

QCharこれは主に、非国際化ソフトウェアに有用です。

注意: 非Latin-1文字とLatin-1 0 (NUL)文字を区別することはできません。このような曖昧さのないunicode() を使用することを推奨する。

unicode()も参照のこと

[noexcept] QChar QChar::toLower() const

文字が大文字または小文字の場合は、小文字に相当するものを返します。

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

これはオーバーロードされた関数です。

これはオーバーロードされた関数です。ucs4 で指定された UCS-4 エンコード文字が大文字またはタイトルケースの場合、その小文字に相当する文字を返します。

注意: Qt 6 以前では、この関数はuint 引数を取り、uint を返していました。

[noexcept] QChar QChar::toTitleCase() const

文字が小文字または大文字の場合、タイトルケースに相当する文字を返します。

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が小文字または大文字の場合、タイトルケースに相当する文字を返します。

注意: Qt 6 以前では、この関数はuint 引数を取り、uint を返していました。

[noexcept] QChar QChar::toUpper() const

文字が小文字または大文字の場合は、大文字に相当する文字を返します。

注意: この関数は、2 文字以上の文字を大文字にする必要がある場合に、元の文字も返します。

QString::toUpper()も参照

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

これはオーバーロードされた関数です。

ucs4 で指定された UCS-4 エンコード文字が小文字またはタイトルケースの場合は、その大文字に相当する文字を返します。

注意: この関数は、2 文字以上の大文字が必要な場合に、元の文字も返します。

注意 : Qt 6 以前では、この関数はuint を引数にとり、uint を返していました。

QString::toUpper()も参照してください

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

QChar の Unicode 数値への参照を返します。

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

QChar の Unicode 値を返します。

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

この文字を導入した Unicode バージョンを返します。

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

これはオーバーロードされた関数です。

ucs4 として UCS-4 エンコード形式で指定された文字を導入した Unicode バージョンを返します。

注意: Qt 6 より前のバージョンでは、この関数はuint を引数にとりました。

関連する非メンバー

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

c1c2 が同じ Unicode 文字でない場合はtrue を返し、そうでない場合はfalse を返します。

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

c1 の Unicode 値がc2 の Unicode 値より小さい場合はtrue を返し、そうでない場合はfalse を返します。

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

charchr をストリームout に書き込みます。

Qt データ型のシリアライズも参照してください

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

c1 の Unicode 値がc2 の Unicode 値以下の場合はtrue を返し、それ以外の場合はfalse を返します。

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

c1c2 が同 じ Unicode キ ャ ラ ク タ の場合はtrue を返し、 そ う でない場合はfalse を返します。

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

c1 の Unicode 数値がc2 の Unicode 数値よ り大きければtrue を返し、 そ う でなければfalse を返す。

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

c1 の Unicode 数値がc2 の Unicode 数値以上であればtrue を返し、そうでなければfalse を返します。

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

ストリームin から char を charchr に読み込みます。

Qt データ型のシリアライズ」も参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。