QChar Class
QChar クラスは、16 ビットの Unicode 文字を扱います。詳細...
| ヘッダー: | #include <QChar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- QCharは、文字列データ用のクラス群の一部です。
注：このクラスのすべての関数は再入可能である。
QChar の比較
| カテゴリ | 比較可能な型 | 説明 |
|---|---|---|
| strong | QChar | |
| strong | char16_t、QString 、QStringView 、QLatin1StringView 、およびQUtf8StringView 。 | |
| strong | 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(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 |
静的パブリックメンバー
| 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文字の全範囲に対して動作します。これらの関数はすべて、その文字が特定の種類の文字である場合はtrueを返し、そうでない場合はfalseを返します。 これらの分類関数には、isNull()（文字が '\0' の場合、true を返す）、isPrint()（文字が空白文字を含むあらゆる種類の印刷可能文字である場合に true を返す）、isPunct()（あらゆる種類の句読点）、isMark()（Unicodeマーク）、isLetter()（文字）、isNumber()（0～9に限らず、あらゆる種類の数字）、isLetterOrNumber()、およびisDigit()（10進数の数字）。 これらはすべて、各文字のUnicodeで定義されたカテゴリを返すcategory()をラップしたものです。これらのうちいくつかは派生プロパティも計算します（例えば、isSpace()は、文字がSeparator_*カテゴリに属する場合、またはOther_Control カテゴリの例外的なコードポイントである場合に、true を返します）。
QCharは、この文字の「自然な」書写方向を示すdirection()も提供しています。joiningType()関数は、その文字が隣接する文字とどのように結合するかを示します（主にアラビア語やシリア語で必要となります）。最後に、hasMirrored()は、その文字が「不自然な」書写方向で印刷される際に反転させる必要があるかどうかを示します。
合成されたUnicode文字（ring など）は、decomposition()を使用することで、分解されたUnicode（「a」の後に「上部の輪」が続く形式）に変換できます。
Unicode では、比較が必ずしも可能とは限らず、大文字小文字の変換は、うまくいっても非常に困難です。「全世界」を網羅する Unicode には、世界中の大文字小文字やソートに関する問題のほとんども含まれています。 operator==() やその派生関数は、文字の数値的な Unicode 値（コードポイント）のみに基づいて比較を行い、toUpper() およびtoLower() は、その文字に明確に定義された大文字／小文字の対応がある場合に大文字・小文字の変換を行います。ロケールに依存する比較を行うには、QString::localeAwareCompare() を使用してください。
変換関数には、unicode()（スカラーへの変換）、toLatin1()（スカラーへの変換。ただし、Latin-1以外のすべての文字を0に変換します）、row()（Unicode行を返します）、cell()（Unicodeセルを返す）、digitValue()（多数の数字文字のいずれかの整数値を返す）、および多数のコンストラクタがあります。
QCharは、従来の8ビットcharとの相互変換を容易にするコンストラクタやキャスト演算子を提供しています。QString のドキュメントで説明されているように、QT_NO_CAST_FROM_ASCII およびQT_NO_CAST_TO_ASCII を定義した場合、8ビットのchar からQCharを生成するには、fromLatin1()を明示的に呼び出すか、QLatin1Char を使用する必要があります。また、8ビットの値を取り戻すには、toLatin1()を呼び出す必要があります。
Qt 6.0 以降、ほとんどの QChar コンストラクタはexplicit となっています。これは、整数型と文字列を誤って混在させてしまうことによる危険なミスを防ぐためです。
詳細については、「Unicode 文字データベースについて」を参照してください。
「Unicode」、「QString 」、および「QLatin1Char 」も参照してください 。
メンバ型のドキュメント
enum QChar::Category
この列挙型は、Unicodeの文字カテゴリを対応付けます。
Unicodeにおいて、以下の文字は規範的です：
| 定数 | 値 | 説明 |
|---|---|---|
QChar::Mark_NonSpacing | 0 | Unicode クラス名 Mn |
QChar::Mark_SpacingCombining | 1 | Unicodeクラス名 Mn |
QChar::Mark_Enclosing | 2 | Unicode クラス名 Me |
QChar::Number_DecimalDigit | 3 | Unicode クラス名 Nd |
QChar::Number_Letter | 4 | Unicode クラス名 Nl |
QChar::Number_Other | 5 | Unicode クラス名 No |
QChar::Separator_Space | 6 | Unicode クラス名 Zs |
QChar::Separator_Line | 7 | Unicode クラス名 Zl |
QChar::Separator_Paragraph | 8 | Unicode クラス名 Zp |
QChar::Other_Control | 9 | Unicode クラス名 Cc |
QChar::Other_Format | 10 | Unicode クラス名 Cf |
QChar::Other_Surrogate | 11 | Unicode クラス名 Cs |
QChar::Other_PrivateUse | 12 | Unicode クラス名 Co |
QChar::Other_NotAssigned | 13 | Unicode クラス名 Cn |
Unicode では、以下のカテゴリは参考情報として扱われます:
| 定数 | 値 | 説明 |
|---|---|---|
QChar::Letter_Uppercase | 14 | Unicode クラス名 Lu |
QChar::Letter_Lowercase | 15 | Unicodeクラス名 Lu |
QChar::Letter_Titlecase | 16 | Unicode クラス名 Lt |
QChar::Letter_Modifier | 17 | Unicode クラス名 Lm |
QChar::Letter_Other | 18 | Unicode クラス名 Lo |
QChar::Punctuation_Connector | 19 | Unicode クラス名 Pc |
QChar::Punctuation_Dash | 20 | Unicode クラス名 Pd |
QChar::Punctuation_Open | 21 | Unicode クラス名 Ps |
QChar::Punctuation_Close | 22 | Unicode クラス名 Pe |
QChar::Punctuation_InitialQuote | 23 | Unicode クラス名 Pi |
QChar::Punctuation_FinalQuote | 24 | Unicode クラス名 Pf |
QChar::Punctuation_Other | 25 | Unicode クラス名 Po |
QChar::Symbol_Math | 26 | Unicode クラス名 Sm |
QChar::Symbol_Currency | 27 | Unicode クラス名 Sc |
QChar::Symbol_Modifier | 28 | Unicode クラス名 Sk |
QChar::Symbol_Other | 29 | Unicode クラス名 So |
関連項目： category()。
enum QChar::Decomposition
この列挙型は、Unicodeの分解属性を定義します。各値の詳細については、Unicode規格を参照してください。
| 定数 | 値 |
|---|---|
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 |
関連項目： decomposition()。
enum QChar::Direction
この列挙型は、Unicodeの方向属性を定義するものです。各値の説明については、Unicode規格を参照してください。
C/C++の命名規則に準拠するため、Unicode標準で使用されるコードの先頭に「Dir」が付けられています。
| 定数 | 値 |
|---|---|
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 |
関連項目： direction()。
enum QChar::JoiningType
5.3以降
この列挙型は、Unicodeの結合型属性を定義します。各値の説明については、Unicode規格を参照してください。
C/C++の命名規則に準拠するため、Unicode規格で使用されているコードの先頭に「Joining_」が付けられています。
| 定数 | 値 |
|---|---|
QChar::Joining_None | 0 |
QChar::Joining_Causing | 1 |
QChar::Joining_Dual | 2 |
QChar::Joining_Right | 3 |
QChar::Joining_Left | 4 |
QChar::Joining_Transparent | 5 |
joiningType()も参照してください 。
enum QChar::Script
この列挙型は、Unicodeのスクリプトプロパティの値を定義します。
Unicode スクリプトプロパティの値の詳細については、Unicode 標準の付録 #24 を参照してください。
C/C++ の命名規則に準拠するため、Unicode 標準で使用されているコードの先頭に「Script_」が付けられています。
| 定数 | 値 | 説明 |
|---|---|---|
QChar::Script_Unknown | 0 | 未割り当て、私的利用、非文字、およびサロゲートコードポイント用。 |
QChar::Script_Inherited | 1 | 複数のスクリプトで使用され、先行する文字からスクリプトを継承する文字用。これには、非スペースマーク、囲みマーク、および幅ゼロのジョイナー/非ジョイナー文字が含まれます。 |
QChar::Script_Common | 2 | 複数の文字体系で使用され、先行する文字からその文字体系を継承しない文字用。 |
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 |
script()も参照してください 。
enum QChar::SpecialCharacter
| 定数 | 値 | 説明 |
|---|---|---|
QChar::Null | 0x0000 | この値を持つQChar isNull ()。 |
QChar::Tabulation | 0x0009 | 文字「タブ」。 |
QChar::LineFeed | 0x000a | |
QChar::FormFeed | 0x000c | |
QChar::CarriageReturn | 0x000d | |
QChar::Space | 0x0020 | |
QChar::Nbsp | 0x00a0 | 固定スペース。 |
QChar::SoftHyphen | 0x00ad | |
QChar::ReplacementCharacter | 0xfffd | フォントに特定のコードポイントに対応するグリフがない場合に表示される文字。多くの場合、特殊な疑問符が使用される。コーデックは、入力データをUnicodeで表現できない場合、このコードポイントを使用する。 |
QChar::ObjectReplacementCharacter | 0xfffc | 画像などのオブジェクトを表示できない場合に、そのオブジェクトを表すために使用されます。 |
QChar::ByteOrderMark | 0xfeff | |
QChar::ByteOrderSwapped | 0xfffe | |
QChar::ParagraphSeparator | 0x2029 | |
QChar::LineSeparator | 0x2028 | |
QChar::VisualTabCharacter (since Qt 6.2) | 0x2192 | 表を水平方向の矢印として表すために使用されます。 |
QChar::LastValidCodePoint | 0x10ffff |
enum QChar::UnicodeVersion
特定の文字がどのバージョンのUnicode規格で導入されたかを指定します。
| 定数 | 値 | 説明 |
|---|---|---|
QChar::Unicode_1_1 | 1 | バージョン 1.1 |
QChar::Unicode_2_0 | 2 | バージョン 2.0 |
QChar::Unicode_2_1_2 | 3 | バージョン 2.1.2 |
QChar::Unicode_3_0 | 4 | バージョン 3.0 |
QChar::Unicode_3_1 | 5 | バージョン 3.1 |
QChar::Unicode_3_2 | 6 | バージョン 3.2 |
QChar::Unicode_4_0 | 7 | バージョン 4.0 |
QChar::Unicode_4_1 | 8 | バージョン 4.1 |
QChar::Unicode_5_0 | 9 | バージョン 5.0 |
QChar::Unicode_5_1 | 10 | バージョン 5.1 |
QChar::Unicode_5_2 | 11 | バージョン 5.2 |
QChar::Unicode_6_0 | 12 | バージョン 6.0 |
QChar::Unicode_6_1 | 13 | バージョン 6.1 |
QChar::Unicode_6_2 | 14 | バージョン 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_16_0 (since Qt 6.9) | 27 | バージョン 16.0 |
QChar::Unicode_17_0 (since Qt 6.11) | 28 | バージョン 17.0 |
QChar::Unicode_Unassigned | 0 | この値は、Unicode バージョン 8.0 ではどの文字にも割り当てられていません。 |
unicodeVersion() およびcurrentUnicodeVersion()も参照してください 。
メンバ関数のドキュメント
[constexpr noexcept] QChar::QChar()
nullのQChar（'\0'）を生成します。
isNull()も参照してください 。
[constexpr noexcept] QChar::QChar(QChar::SpecialCharacter ch)
事前定義された文字値 `ch` に対応する `QChar` オブジェクトを作成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効になっています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を維持するための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[constexpr noexcept] QChar::QChar(QLatin1Char ch)
ASCII/Latin-1 文字「ch 」に対応する QChar を生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタのサポートされている引数型のいずれかに明示的にキャストしてください。
[constexpr noexcept] QChar::QChar(char ch)
ASCII/Latin-1 文字 `ch` に対応する `QChar` を生成します。
注： QT_NO_CAST_FROM_ASCII が定義されている場合、この コンストラクタは使用できません。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け付け、暗黙的にその型に変換されるすべての型を受け付けるわけではありません。下位互換性を維持するための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
QT_NO_CAST_FROM_ASCIIも参照してください 。
[constexpr noexcept] QChar::QChar(char16_t ch)
UTF-16文字「ch 」に対応するQCharを生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタは、コンストラクタの引数型のみを受け付け、暗黙的にその型に変換されるすべての型を受け付けるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[implicit] QChar::QChar(char32_t code)
Unicode コードポイントcode を持つ文字を表す QChar を生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け付け、暗黙的にその型に変換されるすべての型を受け付けるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタがサポートする引数型のいずれかに明示的にキャストしてください。
[explicit constexpr noexcept] QChar::QChar(int code)
Unicode コードポイントcode を持つ文字に対応する QChar を生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[constexpr noexcept] QChar::QChar(short code)
Unicode コードポイントcode を持つ文字に対応する QChar を生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[explicit constexpr noexcept] QChar::QChar(uchar ch)
ASCII/Latin-1 文字 `ch` に対応する `QChar` を生成します。
注： QT_NO_CAST_FROM_ASCII またはQT_RESTRICTED_CAST_FROM_ASCII が定義されている場合、この コンストラクタは使用できません。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
QT_NO_CAST_FROM_ASCII およびQT_RESTRICTED_CAST_FROM_ASCIIも参照してください 。
[explicit constexpr noexcept] QChar::QChar(uint code)
Unicode コードポイントcode を持つ文字に対応する QChar を生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタは、コンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[constexpr noexcept] QChar::QChar(ushort code)
Unicode コードポイントcode を持つ文字に対応する QChar を生成します。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効化されています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[constexpr noexcept] QChar::QChar(wchar_t ch)
ワイド文字ch に対応するQCharを生成します。
注：この コンストラクタは Windows でのみ利用可能です。
注： Qt 6.9以降 、このコンストラクタでは暗黙の型変換が無効になっています。つまり、このコンストラクタはコンストラクタの引数型のみを受け入れ、暗黙的にその型に変換されるすべての型を受け入れるわけではありません。下位互換性を保つための対処法として、QChar コンストラクタでサポートされている引数型のいずれかに明示的にキャストしてください。
[explicit constexpr noexcept] QChar::QChar(uchar cell, uchar row)
行row にある Unicode セルcell に対応する QChar オブジェクトを作成します。
[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)
ucs4 で指定された UCS-4 エンコードの文字に対して、Unicode 規格で定義されている結合クラスを返します。
注： 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 を返します。
注： Qt6以前では 、この関数は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)
xml-ph-0000@deepl.internal配列を含む匿名構造体を返します。
char16_t chars[2]の配列を含み、- QStringView へ暗黙的に変換可能であり、
- C++11の範囲指定forループで反復処理できる、匿名構造体を返します。
c がサロゲートを必要とする場合、chars[0] にはハイサロゲートが、chars[1] にはローサロゲートが格納され、QStringView のサイズは 2 になります。それ以外の場合、chars[0] にはc が格納され、chars[1] はnull となり、QStringView のサイズは 1 になります。
これにより、結果を簡単に利用できます：
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より小さい場合、返される結果は未定義となります。
注： Qt6以前では 、この関数は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 進数の数字（Number_DecimalDigit ）である場合は、true を返します。それ以外の場合は、false を返します。
注： Qt 6以前では 、この関数はuint 型の引数を受け取っていました。
これはオーバーロードされた関数です。
isNumber()も参照してください 。
[constexpr noexcept] bool QChar::isHighSurrogate() const
QChar が UTF-16 サロゲートの上位部分である場合（たとえば、そのコードポイントが [0xd800..0xdbff] の範囲内にある場合）、true を返します。それ以外の場合は false を返します。
[static constexpr noexcept] bool QChar::isHighSurrogate(char32_t ucs4)
ucs4 で指定された UCS-4 エンコード文字が UTF-16 サロゲートのハイパートである場合（例えば、そのコードポイントが [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_* カテゴリ）である場合は、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 を返します。
注： Qt6以前では 、この関数はuint 型の引数を受け取っていました。
これはオーバーロードされた関数です。
[constexpr noexcept] bool QChar::isLowSurrogate() const
QChar が UTF-16 サロゲートのローパートである場合（たとえば、そのコードポイントが [0xdc00..0xdfff] の範囲内にある場合）、true を返します。それ以外の場合は false を返します。
[static constexpr noexcept] bool QChar::isLowSurrogate(char32_t ucs4)
ucs4 で指定された UCS-4 エンコードの文字が UTF-16 サロゲートの下位部分である場合（たとえば、そのコードポイントが [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_* カテゴリ）である場合は、true を返します。それ以外の場合は、false を返します。
注： Qt 6以前では 、この関数はuint 型の引数を受け取っていました。
これはオーバーロードされた関数です。
[constexpr noexcept] bool QChar::isNonCharacter() const
QChar が文字以外の値である場合はtrue を返し、それ以外の場合はfalseを返します。
Unicode には、「非文字」に分類される一定数のコードポイントがあります。つまり、これらはアプリケーションの内部用途には使用できますが、テキストのやり取りには使用できません。 これらは、各 Unicode プレーン ([0xfffe..0xffff], [0x1fffe..0x1ffff] など) の最後の 2 つのエントリ、および範囲 [0xfdd0..0xfdef] 内のエントリです。
[static constexpr noexcept] bool QChar::isNonCharacter(char32_t ucs4)
ucs4 で指定された UCS-4 エンコードの文字が非文字である場合は `true ` を返し、それ以外の場合は `false` を返します。
Unicode には、「非文字」に分類される一定数のコードポイントがあります。つまり、これらはアプリケーションの内部目的には使用できますが、テキストの交換には使用できません。 これらは、各 Unicode プレーン ([0xfffe..0xffff], [0x1fffe..0x1ffff] など) の最後の 2 つのエントリ、および範囲 [0xfdd0..0xfdef] 内のエントリです。
注： Qt 6以前では 、この関数はuint 引数を受け取っていました。
これはオーバーロードされた関数です。
[constexpr noexcept] bool QChar::isNull() const
その文字がUnicode文字0x0000（'\0'）である場合はtrue を返し、それ以外の場合はfalse を返します。
[constexpr noexcept] bool QChar::isNumber() const
その文字が数値（0～9だけでなく、Number_* カテゴリに属する数値）の場合は `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_* カテゴリ）である場合は、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_* カテゴリ）である場合は、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 エンコードの文字がミラー文字である場合は、そのミラー文字を返し、そうでない場合はその文字自体を返します。
注： Qt6以前では 、この関数はuint 引数を受け取り、uint を返していました。
これはオーバーロードされた関数です。
hasMirrored()も参照してください 。
[static constexpr noexcept] bool QChar::requiresSurrogates(char32_t ucs4)
ucs4 で指定された UCS-4 エンコードの文字が、UTF-16 サロゲートのハイパートとローパートに分割できる場合（たとえば、そのコードポイントが 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エンコーディング形式（ucs4 ）で指定された文字のUnicodeスクリプトプロパティの値を返します。
注： Qt 6以前では 、この関数は `uint ` 形式の引数を受け取っていました。
これはオーバーロードされた関数です。
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(char16_t high, char16_t low)
指定されたhigh およびlow の値を持つUTF-16のサロゲートペアを、UCS-4エンコードされたコードポイントに変換します。
注： Qt 6以前では 、この関数はushort 引数を受け取り、uint を返していました。
[static constexpr noexcept] char32_t QChar::surrogateToUcs4(QChar high, QChar low)
UTF-16のサロゲートペア（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文字、または0を返します。これは主に、国際化対応していないソフトウェアで役立ちます。
注： 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 の数値ユニコード値への参照を返します。
[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)
UCS-4エンコーディング形式（ucs4 ）で指定された文字が導入されたUnicodeバージョンを返します。
注： Qt 6以前では 、この関数は `uint ` 形式の引数を受け取っていました。
これはオーバーロードされた関数です。
関連する非メンバ関数
[constexpr noexcept] bool operator!=(const QChar &c1, const QChar &c2)
c1 とc2 が同じ Unicode 文字でない場合は `true ` を返し、そうでない場合は `false` を返します。
[constexpr noexcept] bool operator<(const QChar &c1, const QChar &c2)
c1 の数値としての Unicode 値がc2 の値よりも小さい場合は、true を返します。それ以外の場合は、false を返します。
QDataStream &operator<<(QDataStream &out, QChar chr)
文字列 `chr ` をストリーム `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)
c1 とc2 が同じ Unicode 文字である場合は `true ` を返し、そうでない場合は `false` を返します。
[constexpr noexcept] bool operator>(const QChar &c1, const QChar &c2)
c1 のUnicode数値がc2 の数値よりも大きい場合は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 ` から 1 文字を読み取り、`chr` に格納します。
「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.
