QStringDecoder Class

メンバー関数ドキュメント

[constexpr noexcept] QStringDecoder::QStringDecoder()

デフォルトはデコーダを構築する。デフォルトのデコーダは有効ではないので、テキストの変換には使えない。

[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 で導入されました。

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

HTML metaタグの先頭のバイトオーダマークやcharset指定子からdata の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も参照のこと 。

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; };