QTextCodec Class

QByteArray encodedString = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QString string = codec->toUnicode(encodedString);

QString string = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QByteArray encodedString = codec->fromUnicode(string);

QTextCodec *codec = QTextCodec::codecForName("Shift-JIS");
QTextDecoder *decoder = codec->makeDecoder();

QString string;
while (new_data_available()) {
    QByteArray chunk = get_new_data();
    string += decoder->toUnicode(chunk);
}
delete decoder;

멤버 함수 설명서

[protected] QTextCodec::QTextCodec()

QTextCodec 객체를 생성하고, 이 객체에 가장 높은 우선순위를 부여합니다. QTextCodec은 항상 힙에 생성되어야 합니다(즉, ` new`를 사용하여). Qt가 소유권을 인수하며, 애플리케이션이 종료될 때 이를 삭제합니다.

[virtual noexcept protected] QTextCodec::~QTextCodec()

QTextCodec 를 파기합니다. 코덱은 직접 삭제해서는 안 됩니다. 일단 생성되면 Qt가 관리할 책임이 있습니다.

경고: 이 함수는 재진입 가능하지 않습니다.

[virtual] QList<QByteArray> QTextCodec::aliases() const

하위 클래스는 해당 코덱에 대한 여러 개의 별칭을 반환할 수 있습니다.

코덱에 대한 표준 별칭은 IANA 문자 집합 인코딩 파일에서 확인할 수 있습니다.

[static] QList<QByteArray> QTextCodec::availableCodecs()

사용 가능한 모든 코덱의 목록을 이름별로 반환합니다. 해당 이름에 대한 ‘ QTextCodec ’를 얻으려면 ` QTextCodec::codecForName()`를 호출하십시오.

코덱에 별칭이 있는 경우, 목록에 동일한 코덱이 여러 번 포함될 수 있습니다.

참고: 이 함수는 스레드 안전합니다.

availableMibs(), name(), aliases()도 참조하십시오 .

[static] QList<int> QTextCodec::availableMibs()

사용 가능한 모든 코덱에 대한 MIB 목록을 반환합니다. MIB의 QTextCodec 를 얻으려면 ` QTextCodec::codecForMib()`를 호출하십시오.

참고: 이 함수는 스레드 안전합니다.

availableCodecs() 및 mibEnum()도 참조하십시오 .

bool QTextCodec::canEncode(QChar ch) const

Unicode 문자 ch 가 이 코덱으로 완전히 인코딩될 수 있는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

bool QTextCodec::canEncode(QStringView s) const

유니코드 문자열 s 이 이 코덱으로 완전히 인코딩될 수 있는 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

bool QTextCodec::canEncode(const QString &s) const

s 인코딩 가능 여부를 테스트할 문자열을 포함합니다.

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba, QTextCodec *defaultCodec)

주어진 바이트 배열( ba) 내의 HTML 스니펫에 대한 인코딩을 BOM(Byte Order Mark) 및 콘텐츠 유형 메타 헤더를 확인하여 감지하고, 해당 HTML을 유니코드로 디코딩할 수 있는 QTextCodec 인스턴스를 반환합니다. 제공된 콘텐츠에서 인코딩을 감지할 수 없는 경우, defaultCodec 가 반환됩니다.

codecForUtfText()도 참조하십시오 .

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba)

주어진 바이트 배열 ba 에 포함된 HTML 스니펫의 인코딩을 BOM(Byte Order Mark)과 content-type 메타 헤더를 확인하여 감지하고, 해당 HTML을 유니코드로 디코딩할 수 있는 ` QTextCodec ` 인스턴스를 반환합니다. 인코딩을 감지할 수 없는 경우, 이 오버로드 메서드는 `Latin-1` 인코딩의 ` QTextCodec`을 반환합니다.

[static] QTextCodec *QTextCodec::codecForLocale()

이 로케일에 가장 적합한 코덱에 대한 포인터를 반환합니다.

해당 백엔드가 사용 중인 경우 코덱은 ICU에서 가져오며, 그렇지 않은 경우 OS별 API를 통해 얻을 수 있습니다. 후자의 경우 코덱의 이름은 "System"일 수 있습니다.

참고: 이 함수는 스레드 안전합니다.

setCodecForLocale()도 참조하십시오 .

[static] QTextCodec *QTextCodec::codecForMib(int mib)

MIBenum mib 와 일치하는 QTextCodec 를 반환합니다.

참고: 이 함수는 스레드 안전합니다.

[static] QTextCodec *QTextCodec::codecForName(const QByteArray &name)

설치된 모든 ` QTextCodec ` 객체를 검색하여 ` name`과 가장 잘 일치하는 객체를 반환합니다. 일치 여부는 대소문자를 구분하지 않습니다. ` name `이라는 이름과 일치하는 코덱을 찾을 수 없는 경우 ` nullptr `을 반환합니다.

참고: 이 함수는 스레드 안전합니다.

[static] QTextCodec *QTextCodec::codecForName(const char *name)

설치된 모든 QTextCodec 객체를 검색하여 name 과 가장 잘 일치하는 객체를 반환합니다. 일치 여부는 대소문자를 구분하지 않습니다. name 와 일치하는 코덱을 찾을 수 없는 경우 nullptr 를 반환합니다.

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba, QTextCodec *defaultCodec)

BOM(바이트 순서 표시)을 사용하여 제공된 스니펫 ba 의 인코딩을 감지하고, 해당 텍스트를 유니코드로 디코딩할 수 있는 ` QTextCodec ` 인스턴스를 반환합니다. 이 함수는 다음 코덱 중 하나를 감지할 수 있습니다:

• UTF-32 리틀 엔디안
• UTF-32 빅 엔디안
• UTF-16 리틀 엔디안
• UTF-16 빅 엔디안
• UTF-8

제공된 콘텐츠에서 코덱을 감지할 수 없는 경우, ` defaultCodec `가 반환됩니다.

codecForHtml()도 참조하십시오 .

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba)

BOM(바이트 순서 표시)을 사용하여 제공된 스니펫 ba 의 인코딩을 감지하고, 해당 텍스트를 유니코드로 디코딩할 수 있는 QTextCodec 인스턴스를 반환합니다. 이 함수는 다음 코덱 중 하나를 감지할 수 있습니다:

• UTF-32 리틀 엔디안
• UTF-32 빅 엔디안
• UTF-16 리틀 엔디안
• UTF-16 빅 엔디안
• UTF-8

제공된 콘텐츠에서 코덱을 감지할 수 없는 경우, 이 오버로드 함수는 Latin-1 QTextCodec 를 반환합니다.

codecForHtml()도 참조하십시오 .

[pure virtual protected] QByteArray QTextCodec::convertFromUnicode(const QChar *input, int number, int *state) const

QTextCodec 하위 클래스는 이 함수를 재구현해야 합니다.

input 배열의 첫 번째 number 개 문자를 유니코드에서 서브클래스의 인코딩으로 변환하고, 그 결과를 QByteArray 에 담아 반환합니다.

state nullptr 일 수 있으며, 이 경우 변환은 상태를 갖지 않으며 기본 변환 규칙을 사용해야 합니다. 가 가 아닌 경우, 코덱은 변환 후 상태를 에 저장하고, struct의 및 멤버를 조정해야 합니다. state nullptr state remainingChars invalidChars

[pure virtual protected] QString QTextCodec::convertToUnicode(const char *chars, int len, int *state) const

QTextCodec 하위 클래스는 이 함수를 재구현해야 합니다.

chars 의 처음 len 문자를 서브클래스의 인코딩에서 유니코드로 변환하고, 그 결과를 QString 로 반환합니다.

state nullptr 일 수 있으며, 이 경우 변환은 상태를 유지하지 않으며 기본 변환 규칙을 사용해야 합니다. 가 가 아닌 경우, 코덱은 변환 후 상태를 에 저장하고, struct의 및 멤버를 조정해야 합니다. state nullptr state remainingChars invalidChars

QByteArray QTextCodec::fromUnicode(const QString &str) const

str 를 유니코드에서 이 코덱의 인코딩으로 변환하고, 그 결과를 QByteArray 로 반환합니다.

QByteArray QTextCodec::fromUnicode(const QChar *input, int number, int *state = nullptr) const

input 배열의 앞쪽 number 개의 문자를 유니코드에서 이 코덱의 인코딩으로 변환하고, 그 결과를 QByteArray 에 반환합니다.

사용된 변환기의 state 가 업데이트됩니다.

QByteArray QTextCodec::fromUnicode(QStringView str) const

str 를 유니코드에서 이 코덱의 인코딩으로 변환하고, 그 결과를 QByteArray 에 담아 반환합니다.

QTextDecoder *QTextCodec::makeDecoder(int flags = DefaultConversion) const

지정된 flags 를 사용하여 QTextDecoder 를 생성하고, char * 데이터 청크를 디코딩하여 유니코드 데이터 청크를 생성합니다.

반환된 객체를 삭제하는 것은 호출자의 책임입니다.

QTextEncoder *QTextCodec::makeEncoder(int flags = DefaultConversion) const

지정된 flags 를 사용하여 유니코드 데이터 청크를 char * 데이터로 인코딩하는 QTextEncoder 를 생성합니다.

반환된 객체를 삭제하는 것은 호출자의 책임입니다.

[pure virtual] int QTextCodec::mibEnum() const

QTextCodec 의 하위 클래스는 이 함수를 재구현해야 합니다. 이 함수는 MIBenum을 반환합니다(자세한 내용은 IANA 문자 집합 인코딩 파일을 참조하십시오). 각 QTextCodec 하위 클래스가 이 함수에 대해 올바르고 고유한 값을 반환하는 것이 중요합니다.

[pure virtual] QByteArray QTextCodec::name() const

QTextCodec 파생 클래스는 이 함수를 재구현해야 합니다. 이 함수는 파생 클래스가 지원하는 인코딩의 이름을 반환합니다.

코덱이 IANA 문자 집합 인코딩 파일에 문자 집합으로 등록되어 있는 경우, 이 메서드는 정의되어 있다면 해당 코덱에 대한 선호 MIME 이름을 반환해야 하며, 그렇지 않은 경우 코덱의 이름을 반환해야 합니다.

[static] void QTextCodec::setCodecForLocale(QTextCodec *c)

코덱을 ` c`로 설정합니다. 이는 ` codecForLocale()` 함수에서 반환됩니다. ` c `가 ` nullptr`인 경우, 코덱은 기본값으로 재설정됩니다.

로케일을 설정하기 위해 자체 메커니즘을 사용하려는 일부 애플리케이션에서는 이 설정이 필요할 수 있습니다.

경고: 이 함수는 재진입 가능하지 않습니다.

codecForLocale()도 참조하십시오 .

QString QTextCodec::toUnicode(const QByteArray &a) const

a 를 이 코덱의 인코딩에서 유니코드로 변환하고, 그 결과를 QString 에 담아 반환합니다.

QString QTextCodec::toUnicode(const char *input, int size, int *state = nullptr) const

input 의 첫 번째 size 자리를 이 코덱의 인코딩에서 유니코드로 변환하고, 그 결과를 QString 로 반환합니다.

사용된 변환기의 state 값이 업데이트됩니다.

QString QTextCodec::toUnicode(const char *chars) const

chars 소스 문자를 포함합니다.