QStringDecoder Class

メンバ関数ドキュメント

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

[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

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()も参照 。

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

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

appendToBufferも参照のこと 。