QStringDecoder Class

La classe QStringDecoder fournit un décodeur de texte basé sur l'état. Plus d'informations...

En-tête : #include <QStringDecoder>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core
Héritages : QStringConverter

Note : Toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QStringDecoder()
QStringDecoder(QAnyStringView name, QStringConverter::Flags flags = Flag::Default)
QStringDecoder(QStringConverter::Encoding encoding, QStringConverter::Flags flags = Flag::Default)
QChar *appendToBuffer(QChar *out, QByteArrayView in)
(since 6.6) char16_t *appendToBuffer(char16_t *out, QByteArrayView in)
QStringDecoder::EncodedData<QByteArrayView> decode(QByteArrayView ba)
QStringDecoder::EncodedData<const QByteArray &> decode(const QByteArray &ba)
qsizetype requiredSpace(qsizetype inputLength) const
QStringDecoder::EncodedData<QByteArrayView> operator()(QByteArrayView ba)
QStringDecoder::EncodedData<const QByteArray &> operator()(const QByteArray &ba)

Membres publics statiques

QStringDecoder decoderForHtml(QByteArrayView data)

Description détaillée

Un décodeur de texte convertit un format de texte encodé qui utilise un encodage spécifique dans la représentation interne de Qt.

La conversion de données encodées en QString peut être réalisée à l'aide du code suivant :

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

Le décodeur se souvient de tout état requis entre les appels, de sorte que la conversion de données reçues par morceaux, par exemple, lors de la réception sur un réseau, est tout aussi facile, en appelant le décodeur chaque fois que de nouvelles données sont disponibles :

auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);

QString string;
while (new_data_available()) {
    QByteArray chunk = get_new_data();
    string += toUtf16(chunk);
}

L'objet QStringDecoder conserve l'état entre les morceaux et fonctionne donc correctement même si les morceaux sont séparés au milieu d'une séquence de caractères de plusieurs octets.

Les objets QStringDecoder ne peuvent pas être copiés en raison de leur état interne, mais ils peuvent être déplacés.

Voir également QStringConverter et QStringEncoder.

Documentation des fonctions membres

QStringDecoder::EncodedData<QByteArrayView> QStringDecoder::decode(QByteArrayView ba)

QStringDecoder::EncodedData<QByteArrayView> QStringDecoder::operator()(QByteArrayView ba)

QStringDecoder::EncodedData<const QByteArray &> QStringDecoder::decode(const QByteArray &ba)

QStringDecoder::EncodedData<const QByteArray &> QStringDecoder::operator()(const QByteArray &ba)

Convertit ba et renvoie une structure implicitement convertible en 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()

Default construit un décodeur. Le décodeur par défaut n'est pas valide et ne peut pas être utilisé pour convertir du texte.

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

Crée un objet décodeur en utilisant name et flags. Si name n'est pas le nom d'un encodage connu, un convertisseur invalide sera créé.

Note : Dans les versions de Qt antérieures à 6.8, cette fonction ne prenait qu'un objet const char *, qui devait être encodé en UTF-8.

Voir aussi isValid().

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

Crée un objet décodeur en utilisant encoding et flags.

QChar *QStringDecoder::appendToBuffer(QChar *out, QByteArrayView in)

Décode la séquence d'octets visualisée par in et écrit le résultat décodé dans le tampon commençant par out. Renvoie un pointeur à la fin des données écrites.

out Le tampon doit être suffisamment grand pour pouvoir contenir toutes les données décodées. Utilisez requiredSpace pour déterminer la taille maximale requise pour décoder un tampon de données codées de in.size() octets.

Voir également requiredSpace.

[since 6.6] char16_t *QStringDecoder::appendToBuffer(char16_t *out, QByteArrayView in)

Il s'agit d'une fonction surchargée.

Cette fonction a été introduite dans Qt 6.6.

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

Tente de déterminer le codage du HTML dans data en examinant les marques d'ordre des octets ou un spécificateur de jeu de caractères dans la balise HTML meta et renvoie un QStringDecoder correspondant au codage. Si le décodeur renvoyé n'est pas valide, cela signifie que le codage spécifié n'est pas pris en charge par QStringConverter. Si aucun encodage n'est détecté, la méthode renvoie un décodeur pour Utf8.

Voir aussi isValid().

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

Renvoie la quantité maximale d'unités de code UTF-16 nécessaires pour pouvoir traiter les données encodées sur inputLength.

Voir aussi appendToBuffer.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.