QStringConverter Class

QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
QString string = toUtf16(encodedString);

QString string = "...";
auto fromUtf16 = QStringEncoder(QStringEncoder::Utf8);
QByteArray encodedString = fromUtf16(string);

auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);

QString string;
while (new_data_available() && !toUtf16.hasError()) {
    QByteArray chunk = get_new_data();
    string += toUtf16(chunk);
}
auto result = toUtf16.finalize();
if (result.error != QStringDecoder::FinalizeResult::Error::NoError) {
    // Handle error
}

멤버 함수 설명서

[noexcept default] QStringConverter::QStringConverter(QStringConverter &&)

QStringConverter 의 인스턴스를 Move 방식으로 생성합니다.

[noexcept protected default] QStringConverter::~QStringConverter()

QStringConverter 의 인스턴스를 삭제합니다.

[static] QStringList QStringConverter::availableCodecs()

지원되는 코덱 이름의 목록을 반환합니다. 이 함수가 반환하는 이름은 QStringEncoder 및 QStringDecoder 의 생성자에 전달하여, 주어진 코덱에 대한 인코더 또는 디코더를 생성하는 데 사용할 수 있습니다.

이 함수는 표준 코덱 이외의 추가 코덱 목록을 얻기 위해 사용할 수 있습니다. 추가 코덱을 지원하려면 Qt를 ICU 라이브러리 지원 옵션으로 컴파일해야 합니다.

[static noexcept] std::optional<QStringConverter::Encoding> QStringConverter::encodingForData(QByteArrayView data, char16_t expectedFirstCharacter = 0)

data 의 콘텐츠 인코딩을 확인할 수 있는 경우 해당 인코딩을 반환합니다. 인코딩을 확인하는 데 도움이 되도록 expectedFirstCharacter 을 추가 힌트로 전달할 수 있습니다.

인코딩을 명확히 파악할 수 없는 경우, 반환되는 옵셔널은 비어 있습니다.

[static] std::optional<QStringConverter::Encoding> QStringConverter::encodingForHtml(QByteArrayView data)

data 의 HTML 인코딩을, 선행 바이트 순서 표시(BOM)나 HTML 메타 태그의 문자 집합 지정자를 확인하여 파악하려고 시도합니다. 선택적 매개변수가 비어 있는 경우, 지정된 인코딩은 QStringConverter 에서 지원되지 않습니다. 인코딩이 감지되지 않으면 이 메서드는 Utf8을 반환합니다.

QStringDecoder::decoderForHtml()도 참조하십시오 .

[static noexcept] std::optional<QStringConverter::Encoding> QStringConverter::encodingForName(QAnyStringView name)

name 를 해당 Encoding 멤버로 변환합니다(해당 멤버가 있는 경우).

name 가 Encoding 열거형에 나열된 코덱 이름이 아닌 경우, std::nullopt 가 반환됩니다. 다만, Qt가 ICU와 함께 빌드된 경우, ICU가 주어진 이름의 변환기를 제공하는 한 QStringConverter 생성자에서 해당 이름을 허용할 수 있습니다.

[noexcept] bool QStringConverter::hasError() const

변환 과정에서 문자를 올바르게 변환할 수 없는 경우 true를 반환합니다. 예를 들어, 유효하지 않은 UTF-8 시퀀스가 있거나 대상 인코딩의 제한으로 인해 문자를 변환할 수 없는 경우 등이 이에 해당합니다.

[noexcept] bool QStringConverter::isValid() const

이 객체가 텍스트 인코딩 또는 디코딩에 사용할 수 있는 유효한 문자열 변환기인 경우 true를 반환합니다.

기본 생성된 문자열 변환기나 지원되지 않는 이름으로 생성된 변환기는 유효하지 않습니다.

[noexcept] const char *QStringConverter::name() const

이 QStringConverter 가 인코딩하거나 디코딩할 수 있는 인코딩의 표준 이름을 반환합니다. 변환기가 유효하지 않은 경우 nullptr을 반환합니다. 반환된 이름은 UTF-8로 인코딩되어 있습니다.

isValid()도 참조하십시오 .

[static noexcept] const char *QStringConverter::nameForEncoding(QStringConverter::Encoding e)

인코딩 e 의 정규 이름을 반환하며, e 가 유효하지 않은 값인 경우 nullptr 을 반환합니다.

[noexcept] void QStringConverter::resetState()

컨버터의 내부 상태를 초기화하여 잠재적인 오류나 부분적인 변환을 제거합니다.

[noexcept default] QStringConverter &QStringConverter::operator=(QStringConverter &&)

other 를 이 QStringConverter 인스턴스에 할당합니다.