QStringDecoder Class

멤버 함수 문서

[constexpr noexcept] QStringDecoder::QStringDecoder()

default는 디코더를 생성합니다. 기본 디코더는 유효하지 않으며, 텍스트 변환에 사용할 수 없습니다.

[explicit] QStringDecoder::QStringDecoder(QAnyStringView name, QStringConverter::Flags flags = Flag::Default)

name 와 flags 를 사용하여 디코더 객체를 생성합니다. name 가 알려진 인코딩의 이름이 아닌 경우, 유효하지 않은 변환기가 생성됩니다.

isValid()도 참조하십시오 .

[explicit constexpr] QStringDecoder::QStringDecoder(QStringConverter::Encoding encoding, QStringConverter::Flags flags = Flag::Default)

encoding 와 flags 를 사용하여 디코더 객체를 생성합니다.

QChar *QStringDecoder::appendToBuffer(QChar *out, QByteArrayView in)

in 에서 처리하는 바이트 시퀀스를 디코딩하고, 디코딩된 결과를 out 에서 시작하는 버퍼에 기록합니다. 기록된 데이터의 끝을 가리키는 포인터를 반환합니다.

out 는 모든 디코딩된 데이터를 수용할 수 있을 만큼 충분히 커야 합니다. requiredSpace 를 사용하여 in.size() 바이트 크기의 인코딩된 데이터 버퍼를 디코딩하는 데 필요한 최대 크기를 확인하십시오. 이 함수는 out 과 out + requiredSpace() 사이의 임의의 바이트 영역에 데이터를 쓸 수 있으며, 여기에는 반환된 끝 포인터를 넘어가는 영역도 포함됩니다.

requiredSpace도 참조하십시오 .

[since 6.6] char16_t *QStringDecoder::appendToBuffer(char16_t *out, QByteArrayView in)

이 함수는 Qt 6.6에서 도입되었습니다.

ba 를 변환하고, QString 로 암시적으로 변환 가능한 구조체를 반환합니다.

QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
auto data = toUtf16(encodedString); // data's type is QStringDecoder::EncodedData<const QByteArray &>
QString string = toUtf16(encodedString); // Implicit conversion to QString

// Here you have to cast "data" to QString
auto func = [&]() { return !toUtf16.hasError() ? QString(data) : u"foo"_s; };

[static] QStringDecoder QStringDecoder::decoderForHtml(QByteArrayView data)

data 의 HTML 인코딩을 확인하기 위해 HTML 메타 태그 내의 선행 바이트 순서 표시(BOM) 또는 문자 집합 지정자를 검사하고, 해당 인코딩과 일치하는 QStringDecoder 를 반환합니다. 반환된 디코더가 유효하지 않은 경우, 지정된 인코딩은 QStringConverter 에서 지원되지 않는 것입니다. 인코딩이 감지되지 않으면 이 메서드는 Utf8용 디코더를 반환합니다.

isValid()도 참조하십시오 .

디코더에 더 이상 데이터가 도착하지 않음을 알립니다.

또한 디코딩이 보류 중이던 잔여 콘텐츠의 데이터를 제공할 수도 있습니다. 처리해야 할 잔여 데이터가 없는 경우, 반환 값의 ` error ` 필드는 ` NoError`로 설정됩니다.

out 가 제공되고 null이 아닌 경우, 이 필드에는 최대 maxlen 개의 문자가 기록될 수 있는 공간이 있어야 합니다. 잔여 출력의 이만큼의 문자가 이 공간에 기록되며, 끝은 반환 값의 next 필드로 표시됩니다. 일반적으로 이 잔여 데이터는 변환되지 않은 나머지 입력 문자 하나당 하나의 대체 문자로 구성되어야 합니다.

모든 잔여 내용이 out 를 통해 전달되었거나, out 가 nullptr 인 경우, 또는 잔여 데이터가 없는 경우, finalize()에서 반환되면 디코더가 재설정됩니다. 그렇지 않은 경우, finalize()를 추가로 호출하여 남은 데이터를 가져오거나 버릴 수 있습니다.

이 함수들은 Qt 6.11에서 도입되었습니다.

hasError() 및 appendToBuffer()도 참조하십시오 .

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

inputLength 로 인코딩된 데이터를 처리하는 데 필요한 UTF-16 코드 유닛의 최대 개수를 반환합니다.

appendToBuffer도 참조하십시오 .