QStringConverter Class

QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
QString string = toUtf16(encodedString);

QString string = "...";
auto fromUtf16 = QStringEncoder(QStringEncoder::Utf8);
QByteArray encodedString = fromUtf16(string);

auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);

QString string;
while (new_data_available() && !toUtf16.hasError()) {
    QByteArray chunk = get_new_data();
    string += toUtf16(chunk);
}
auto result = toUtf16.finalize();
if (result.error != QStringDecoder::FinalizeResult::Error::NoError) {
    // Handle error
}

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

[noexcept default] QStringConverter::QStringConverter(QStringConverter &&)

QStringConverter のインスタンスをMoveコンストラクタで生成します。

[noexcept protected default] QStringConverter::~QStringConverter()

QStringConverter のインスタンスを破棄します。

[static] QStringList QStringConverter::availableCodecs()

サポートされているコーデックの名前の一覧を返します。この関数が返す名前は、QStringEncoder やQStringDecoder のコンストラクタに渡すことで、指定されたコーデック用のエンコーダまたはデコーダを作成することができます。

この関数は、標準のコーデック以外の追加のコーデックの一覧を取得するために使用できます。追加のコーデックをサポートするには、QtをICUライブラリをサポートするようにコンパイルする必要があります。

[static noexcept] std::optional<QStringConverter::Encoding> QStringConverter::encodingForData(QByteArrayView data, char16_t expectedFirstCharacter = 0)

data のコンテンツのエンコーディングが特定できる場合、そのエンコーディングを返します。エンコーディングの特定を補助するために、追加のヒントとして `expectedFirstCharacter ` を渡すことができます。

エンコーディングが不明な場合、返されるオプショナルは空になります。

[static] std::optional<QStringConverter::Encoding> QStringConverter::encodingForHtml(QByteArrayView data)

data 内の HTML のエンコーディングを、先頭のバイト順マークや HTML メタタグ内の文字セット指定子を確認して判定しようとします。オプションが空の場合、指定されたエンコーディングはQStringConverter ではサポートされていません。エンコーディングが検出されない場合、このメソッドは Utf8 を返します。

QStringDecoder::decoderForHtml()も参照してください 。

[static noexcept] std::optional<QStringConverter::Encoding> QStringConverter::encodingForName(QAnyStringView name)

name を、対応するEncoding メンバーが存在する場合、そのメンバーに変換します。

name が Encoding 列挙型にリストされているコーデックの名前でない場合、std::nullopt が返されます。ただし、Qt が ICU とともにビルドされており、ICU が指定された名前のコンバータを提供している場合は、そのような名前でもQStringConverter のコンストラクタによって受け入れられる可能性があります。

[noexcept] bool QStringConverter::hasError() const

変換処理で文字を正しく変換できなかった場合、true を返します。これは、例えば無効な UTF-8 シーケンスがあった場合や、ターゲットエンコーディングの制限により文字を変換できない場合などに発生することがあります。

[noexcept] bool QStringConverter::isValid() const

これが、テキストのエンコードまたはデコードに使用できる有効な文字列コンバータである場合、true を返します。

デフォルトで生成された文字列コンバータや、サポートされていない名前で生成されたコンバータは有効ではありません。

[noexcept] const char *QStringConverter::name() const

このQStringConverter がエンコードまたはデコードできるエンコーディングの正規名を返します。コンバータが無効な場合はnullptrを返します。返される名前はUTF-8でエンコードされています。

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

[static noexcept] const char *QStringConverter::nameForEncoding(QStringConverter::Encoding e)

エンコーディングの正規名を返します。e が不正な値の場合、e またはnullptr を返します。

[noexcept] void QStringConverter::resetState()

コンバータの内部状態をリセットし、発生しているエラーや部分的な変換をクリアします。

[noexcept default] QStringConverter &QStringConverter::operator=(QStringConverter &&)

other をこのQStringConverter インスタンスに割り当てます。