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 は、デコードされたデータ全体を格納できる十分な大きさである必要があります。in.size() バイトのエンコード済みデータバッファをデコードするために必要な最大サイズを判断するには、requiredSpace を使用してください。この関数は、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 メタタグ内の文字セット指定子を確認して判定し、そのエンコーディングに一致する `QStringDecoder ` を返します。返されたデコーダーが無効な場合、指定されたエンコーディングはQStringConverter ではサポートされていません。エンコーディングが検出されない場合、このメソッドは Utf8 用のデコーダーを返します。

isValid()も参照してください 。

デコーダに対し、これ以上のデータは到着しないことを通知します。

また、デコード待ちだった残りのコンテンツからのデータを提供する場合もあります。処理すべき残りのデータがない場合、このリターンの `error ` フィールドには `NoError` が設定されます。

out が指定され、かつnullでない場合、最大maxlen 文字が書き込めるスペースが確保されていなければならない。最大この文字数分の残存出力データがこのスペースに書き込まれ、その終了位置は戻り値のnext フィールドによって示される。通常、この残存データは、変換されていない残りの入力文字1文字につき1つの置換文字で構成されるものとする。

残りの内容がすべてout を介して送信された場合、out がnullptr である場合、または残りのデータが存在しない場合、finalize()からの戻り時にデコーダはリセットされます。それ以外の場合は、finalize()を再度呼び出すことで、残りのデータを取得または破棄することができます。

これらの関数は Qt 6.11 で導入されました。

hasError() およびappendToBuffer()も参照してください 。

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

inputLength でエンコードされたデータを処理するために必要な、UTF-16コードユニットの最大数を返します。

「appendToBuffer」も参照してください 。