QStringEncoder Class

멤버 함수 설명서

[constexpr noexcept] QStringEncoder::QStringEncoder()

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

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

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

isValid()도 참조하십시오 .

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

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

char *QStringEncoder::appendToBuffer(char *out, QStringView in)

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

requiredSpace()도 참조하십시오 .

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

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

// Here you have to cast "data" to QByteArray
auto func = [&]() { return !fromUtf16.hasError() ? QByteArray(data) : "foo"_ba; };

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

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

out 가 제공되고 null이 아닌 경우, 최대 maxlen 개의 문자가 기록될 수 있는 공간이 반드시 있어야 합니다. 이 공간에는 최대 이만큼의 잔여 출력 문자가 기록되며, 끝은 반환 값의 next 필드로 표시됩니다. 일반적으로 이 잔여 데이터는 변환되지 않은 나머지 입력 문자 하나당 하나의 대체 문자로 구성되어야 합니다. ISO-2022-JP와 같은 상태 기반 인코딩을 사용하는 경우, 문자 스트림에서 현재 상태를 복원하거나 종료하기 위한 바이트가 여기에 기록될 수도 있습니다.

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

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

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

qsizetype QStringEncoder::requiredSpace(qsizetype inputLength) const

inputLength 로 디코딩된 데이터를 처리하는 데 필요한 최대 문자 수를 반환합니다.

appendToBuffer()도 참조하십시오 .