QChar Class
QChar 클래스는 16비트 유니코드 문자를 제공합니다. 더 보기...
| 헤더: | #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에서 유니코드 문자는 마크업이나 구조가 없는 16비트 엔티티입니다. 이 클래스는 그러한 엔티티를 나타냅니다. 이 클래스는 가볍기 때문에 어디서나 사용할 수 있습니다. 대부분의 컴파일러는 이 클래스를 ` unsigned short`와 동일하게 취급합니다.
QChar는 테스트 및 분류 함수, 다른 형식과의 상호 변환, 합성 유니코드에서 분해된 유니코드로의 변환 기능을 모두 제공하며, 요청 시 문자 비교 및 대소문자 변환을 시도합니다.
분류 함수에는 표준 C++ 헤더 <cctype>(이전의 <ctype.h>)에 포함된 함수들과 유사한 것들이 포함되지만, ASCII 범위뿐만 아니라 전체 유니코드 문자 범위를 대상으로 작동합니다. 이 함수들은 모두 문자가 특정 유형일 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다. 이러한 분류 함수로는 isNull() (문자가 '\0'인 경우 true 를 반환), isPrint() (문자가 공백을 포함한 인쇄 가능한 모든 종류의 문자일 경우 true), isPunct() (모든 종류의 구두점), isMark() (유니코드 마크), isLetter() (문자), isNumber() (0-9뿐만 아니라 모든 종류의 숫자 문자), isLetterOrNumber(), isDigit() (십진수 자릿수). 이들 모두는 각 문자의 유니코드 정의 범주를 반환하는 category()을 래핑한 함수들입니다. 이 중 일부는 파생 속성도 계산합니다(예를 들어, isSpace()은 문자가 Separator_* 범주에 속하거나 Other_Control 범주의 예외 코드 포인트인 경우 true 을 반환합니다).
QChar는 또한 이 문자의 “자연스러운” 쓰기 방향을 나타내는 direction() 함수를 제공합니다. joiningType() 함수는 문자가 인접한 문자와 어떻게 연결되는지를 나타내며(주로 아랍어나 시리아어에 필요함), 마지막으로 hasMirrored() 함수는 문자가 “비자연적인” 쓰기 방향으로 출력될 때 거울 반전되어야 하는지 여부를 나타냅니다.
합성 유니코드 문자(예: ring)는 decomposition()를 사용하여 분해된 유니코드("a" 뒤에 "링 위"가 오는 형태)로 변환할 수 있습니다.
유니코드에서는 문자 비교가 반드시 가능한 것은 아니며, 대소문자 변환은 기껏해야 매우 어렵습니다. “전 세계”를 아우르는 유니코드는 전 세계의 대소문자 및 정렬 문제 대부분을 포함하고 있습니다. operator==() 및 관련 함수들은 문자들의 순수한 수치 유니코드 값(코드 포인트)을 기반으로 비교를 수행하며, toUpper() 및 toLower()는 해당 문자에 명확하게 정의된 대문자/소문자 대응형이 있을 때 대소문자 변환을 수행합니다. 로케일에 의존적인 비교를 위해서는 QString::localeAwareCompare()를 사용하십시오.
변환 함수에는 unicode()(스칼라로 변환), toLatin1()(스칼라로 변환하되, Latin-1이 아닌 모든 문자를 0으로 변환), row()(유니코드 행을 반환), cell() (유니코드 셀 반환), 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 로 변경되었습니다. 이는 정수형과 문자열을 실수로 혼합하여 발생할 수 있는 위험한 실수를 방지하기 위한 조치입니다.
자세한 내용은 “유니코드 문자 데이터베이스에 대하여”를 참조하십시오.
또한 유니코드, QString 및 QLatin1Char 도참조하십시오 .
멤버 유형 문서
enum QChar::Category
이 열거형은 유니코드 문자 범주를 매핑합니다.
다음 문자들은 유니코드에서 규범적인 문자들입니다:
| 상수 | 값 | 설명 |
|---|---|---|
QChar::Mark_NonSpacing | 0 | 유니코드 클래스 이름 Mn |
QChar::Mark_SpacingCombining | 1 | 유니코드 클래스 이름 Mn Mc |
QChar::Mark_Enclosing | 2 | 유니코드 클래스 이름 Me |
QChar::Number_DecimalDigit | 3 | 유니코드 클래스 이름 Nd |
QChar::Number_Letter | 4 | 유니코드 클래스 이름 Nl |
QChar::Number_Other | 5 | 유니코드 클래스 이름 No |
QChar::Separator_Space | 6 | 유니코드 클래스 이름 Zs |
QChar::Separator_Line | 7 | 유니코드 클래스 이름 Zl |
QChar::Separator_Paragraph | 8 | 유니코드 클래스 이름 Zp |
QChar::Other_Control | 9 | 유니코드 클래스 이름 Cc |
QChar::Other_Format | 10 | 유니코드 클래스 이름 Cf |
QChar::Other_Surrogate | 11 | 유니코드 클래스 이름 Cs |
QChar::Other_PrivateUse | 12 | 유니코드 클래스 이름 Co |
QChar::Other_NotAssigned | 13 | 유니코드 클래스 이름 Cn |
유니코드에서 다음 범주는 참고용입니다:
| 상수 | 값 | 설명 |
|---|---|---|
QChar::Letter_Uppercase | 14 | 유니코드 클래스 이름 Lu |
QChar::Letter_Lowercase | 15 | 유니코드 클래스 이름 Lu |
QChar::Letter_Titlecase | 16 | 유니코드 클래스 이름 Lt |
QChar::Letter_Modifier | 17 | 유니코드 클래스 이름 Lm |
QChar::Letter_Other | 18 | 유니코드 클래스 이름 Lo |
QChar::Punctuation_Connector | 19 | 유니코드 클래스 이름 Pc |
QChar::Punctuation_Dash | 20 | 유니코드 클래스 이름 Pd |
QChar::Punctuation_Open | 21 | 유니코드 클래스 이름 Ps |
QChar::Punctuation_Close | 22 | 유니코드 클래스 이름 Pe |
QChar::Punctuation_InitialQuote | 23 | 유니코드 클래스 이름 Pi |
QChar::Punctuation_FinalQuote | 24 | 유니코드 클래스 이름 Pf |
QChar::Punctuation_Other | 25 | 유니코드 클래스 이름 Po |
QChar::Symbol_Math | 26 | 유니코드 클래스 이름 Sm |
QChar::Symbol_Currency | 27 | 유니코드 클래스 이름 Sc |
QChar::Symbol_Modifier | 28 | 유니코드 클래스 이름 Sk |
QChar::Symbol_Other | 29 | 유니코드 클래스 이름 So |
category()도 참조하십시오 .
enum QChar::Decomposition
이 열거형 유형은 유니코드 분해 속성을 정의합니다. 각 값에 대한 설명은 유니코드 표준을 참조하십시오.
| 상수 | 값 |
|---|---|
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
이 열거형 유형은 유니코드 방향 속성을 정의합니다. 각 값에 대한 설명은 유니코드 표준을 참조하십시오.
C/C++ 명명 규칙을 따르기 위해 유니코드 표준에서 사용되는 코드 앞에 "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부터
이 열거형(enum)은 유니코드 결합 유형 속성을 정의합니다. 각 값에 대한 설명은 유니코드 표준을 참조하십시오.
C/C++ 명명 규칙을 따르기 위해 유니코드 표준에서 사용되는 코드 앞에 "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
이 열거형 유형은 유니코드 문자 체계 속성 값을 정의합니다.
유니코드 스크립트 속성 값에 대한 자세한 내용은 유니코드 표준 부록 #24를 참조하십시오.
C/C++ 명명 규칙을 따르기 위해 유니코드 표준에서 사용되는 코드 앞에 "Script_"가 접두사로 붙습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QChar::Script_Unknown | 0 | 할당되지 않은, 사용, 비문자 및 대리 코드 포인트의 경우. |
QChar::Script_Inherited | 1 | 여러 문자 체계에서 사용될 수 있고, 앞의 문자로부터 문자 체계를 상속받는 문자의 경우. 여기에는 비공백 기호, 묶음 기호, 폭이 0인 결합/비결합 문자가 포함됩니다. |
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 | 글꼴에 특정 코드포인트에 해당하는 글리프가 없을 때 표시되는 문자입니다. 대개 특수한 물음표 문자가 사용됩니다. 코덱은 입력 데이터를 유니코드로 표현할 수 없을 때 이 코드포인트를 사용합니다. |
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
특정 문자가 유니코드 표준의 어느 버전에서 처음 도입되었는지 명시합니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 | 이 값은 유니코드 버전 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)
유니코드 코드 포인트 code 인 문자에 대한 QChar 객체를 생성합니다.
참고: Qt 6.9부터 이 생성자에 대한 암시적 변환이 비활성화되었습니다. 즉, 이 생성자는 생성자 인자 유형만 허용하며, 암시적으로 해당 유형으로 변환되는 모든 값은 허용하지 않습니다. 하위 호환성을 유지하기 위한 해결 방법은 QChar 생성자가 지원하는 인자 유형 중 하나로 명시적으로 형변환하는 것입니다.
[explicit constexpr noexcept] QChar::QChar(int code)
유니코드 코드 포인트가 code 인 문자에 대한 QChar 객체를 생성합니다.
참고: Qt 6.9부터 이 생성자에 대한 암시적 변환이 비활성화되었습니다. 즉, 이 생성자는 생성자 인자 유형만 허용하며, 암시적으로 해당 유형으로 변환되는 모든 값은 허용하지 않습니다. 하위 호환성을 유지하기 위한 해결 방법은 QChar 생성자가 지원하는 인자 유형 중 하나로 명시적으로 형변환하는 것입니다.
[constexpr noexcept] QChar::QChar(short code)
유니코드 코드 포인트 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)
유니코드 코드 포인트 code 인 문자에 대한 QChar 객체를 생성합니다.
참고: Qt 6.9부터 이 생성자에 대한 암시적 변환이 비활성화되었습니다. 즉, 이 생성자는 생성자 인자 유형만을 받아들이며, 암시적으로 해당 유형으로 변환되는 모든 값을 받아들이지는 않습니다. 하위 호환성을 유지하기 위한 해결책은 QChar 생성자가 지원하는 인자 유형 중 하나로 명시적으로 형변환하는 것입니다.
[constexpr noexcept] QChar::QChar(ushort code)
유니코드 코드 포인트 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 의 유니코드 셀 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
유니코드 문자의 셀(최하위 바이트)을 반환합니다.
row()도 참조하십시오 .
[noexcept] unsigned char QChar::combiningClass() const
유니코드 표준에 정의된 대로 해당 문자의 결합 클래스를 반환합니다. 이는 주로 기본 문자에 부착된 표시에 대한 위치 지정 힌트로 유용합니다.
Qt 텍스트 렌더링 엔진은 이 정보를 사용하여 기본 문자 주위에 비공백 마크를 올바르게 배치합니다.
[static noexcept] unsigned char QChar::combiningClass(char32_t ucs4)
ucs4 로 지정된 UCS-4 인코딩 문자(Unicode 표준에 정의된 바와 같이)에 대한 결합 클래스를 반환합니다.
참고: Qt 6이전 버전에서는 이 함수가 uint 인자를 받았습니다.
이 함수는 오버로드된 함수입니다.
[static noexcept] QChar::UnicodeVersion QChar::currentUnicodeVersion()
지원되는 가장 최신 유니코드 버전을 반환합니다.
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입니다.
이를 통해 결과를 쉽게 활용할 수 있습니다:
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
문자가 십진수 숫자(Number_DecimalDigit)인 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.
isNumber()도 참조하십시오 .
[static constexpr noexcept] bool QChar::isDigit(char32_t ucs4)
ucs4 로 지정된 UCS-4 인코딩 문자가 십진수 숫자(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 를 반환합니다.
참고: Qt 6이전 버전에서는 이 함수가 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`를 반환합니다.
유니코드에는 "비문자(non-characters)"로 분류되는 특정 수의 코드 포인트가 있습니다. 즉, 이러한 코드 포인트는 애플리케이션의 내부 용도로는 사용할 수 있지만, 텍스트 교환용으로는 사용할 수 없습니다. 이는 각 유니코드 평면([0xfffe..0xffff], [0x1fffe..0x1ffff] 등)의 마지막 두 항목과 [0xfdd0..0xfdef] 범위의 항목들입니다.
[static constexpr noexcept] bool QChar::isNonCharacter(char32_t ucs4)
ucs4 로 지정된 UCS-4 인코딩 문자가 비문자인 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.
유니코드에는 "비문자"로 분류되는 특정 수의 코드 포인트가 있습니다. 즉, 이러한 코드 포인트는 애플리케이션의 내부 용도로는 사용할 수 있지만, 텍스트 교환용으로는 사용할 수 없습니다. 이는 각 유니코드 평면([0xfffe..0xffff], [0x1fffe..0x1ffff] 등)의 마지막 두 항목과 [0xfdd0..0xfdef] 범위의 항목들입니다.
참고: Qt 6이전에는 이 함수가 uint 인수를 받았습니다.
이 함수는 오버로드된 함수입니다.
[constexpr noexcept] bool QChar::isNull() const
해당 문자가 유니코드 문자 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 대리 범위(surrogate range)의 상위 또는 하위 부분에 속하는 코드 포인트가 포함된 경우(예를 들어, 코드 포인트가 [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
문자가 제목대소문자(titlecase)인 경우 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 인코딩 문자가 UTF-16 대리자의 상위 부분과 하위 부분으로 나눌 수 있는 경우(예를 들어, 해당 코드 포인트가 0x10000 이상인 경우) true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.
참고: Qt 6이전 버전에서는 이 함수가 uint 인자를 받았습니다.
[constexpr noexcept] uchar QChar::row() const
유니코드 문자의 행(최상위 바이트)을 반환합니다.
cell()도 참조하십시오 .
[noexcept] QChar::Script QChar::script() const
이 문자의 유니코드 스크립트 속성 값을 반환합니다.
[static noexcept] QChar::Script QChar::script(char32_t ucs4)
UCS-4로 인코딩된 형식( ucs4)으로 지정된 문자의 유니코드 스크립트 속성 값을 반환합니다.
참고: 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
해당 문자의 대소문자 변환된 값을 반환합니다. 대부분의 유니코드 문자에 대해 이 함수는 ` toLower()`와 동일한 결과를 반환합니다.
[static noexcept] char32_t QChar::toCaseFolded(char32_t ucs4)
ucs4 로 지정된 UCS-4 인코딩 문자의 대소문자 변환된 등가값을 반환합니다. 대부분의 유니코드 문자에 대해 이 함수는 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
문자가 소문자이거나 제목 대문자인 경우 해당 문자의 대문자 형태를 반환하고, 그렇지 않은 경우 해당 문자 자체를 반환합니다.
참고: 이 함수는 해당 문자의 대문자 형태가 두 개 이상의 문자로 구성되는 드문 경우에도 원래 문자를 반환합니다.
참조: ` QString::toUpper()` 함수.
[static noexcept] char32_t QChar::toUpper(char32_t ucs4)
ucs4 로 지정된 UCS-4 인코딩 문자가 소문자이거나 제목용 대문자인 경우, 해당 문자의 대문자 형태를 반환하고, 그렇지 않은 경우 해당 문자 자체를 반환합니다.
참고: 이 함수는 해당 문자의 대문자 형태가 두 개 이상의 문자로 구성되어야 하는 드문 경우에도 원래 문자를 반환합니다.
참고: Qt 6이전 버전에서는 이 함수가 uint 인자를 받아 uint 를 반환했습니다.
이 함수는 오버로드된 함수입니다.
QString::toUpper()도 참조하십시오 .
[constexpr noexcept] char16_t &QChar::unicode()
QChar 의 숫자형 유니코드 값에 대한 참조를 반환합니다.
[constexpr noexcept] char16_t QChar::unicode() const
QChar 의 숫자형 유니코드 값을 반환합니다.
[noexcept] QChar::UnicodeVersion QChar::unicodeVersion() const
이 문자가 도입된 유니코드 버전을 반환합니다.
[static noexcept] QChar::UnicodeVersion QChar::unicodeVersion(char32_t ucs4)
UCS-4 인코딩 형식( ucs4)으로 지정된 문자가 처음 도입된 유니코드 버전을 반환합니다.
참고: Qt 6이전에는 이 함수가 uint 형식의 인수를 받았습니다.
이 함수는 오버로드된 함수입니다.
관련 비회원 함수
[constexpr noexcept] bool operator!=(const QChar &c1, const QChar &c2)
c1 와 c2 가 동일한 유니코드 문자가 아닐 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
[constexpr noexcept] bool operator<(const QChar &c1, const QChar &c2)
c1 의 숫자형 유니코드 값이 c2 의 값보다 작으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
QDataStream &operator<<(QDataStream &out, QChar chr)
chr 문자열을 out 스트림에 기록합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
[constexpr noexcept] bool operator<=(const QChar &c1, const QChar &c2)
c1 의 숫자형 유니코드 값이 c2 의 값보다 작거나 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
[constexpr noexcept] bool operator==(const QChar &c1, const QChar &c2)
c1 와 c2 가 동일한 유니코드 문자일 경우 true 를 반환하고, 그렇지 않을 경우 false 를 반환합니다.
[constexpr noexcept] bool operator>(const QChar &c1, const QChar &c2)
c1 의 숫자형 유니코드 값이 c2 의 값보다 크면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
[constexpr noexcept] bool operator>=(const QChar &c1, const QChar &c2)
c1 의 숫자형 유니코드 값이 c2 의 값보다 크거나 같으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
QDataStream &operator>>(QDataStream &in, QChar &chr)
in 스트림에서 char 값을 읽어와 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.
