QStringDecoder Class

Documentation des fonctions membres

[constexpr noexcept] QStringDecoder::QStringDecoder()

La valeur par défaut crée 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 à l’aide de name et flags. Si name n’est pas le nom d’un encodage connu, un convertisseur non valide sera créé.

Voir également isValid().

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

Crée un objet décodeur à l'aide de encoding et flags.

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

Décode la séquence d'octets traitée par in et écrit le résultat du décodage dans le tampon à partir de l'adresse out. Renvoie un pointeur vers la fin des données écrites.

out 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. Cette fonction peut écrire dans n'importe quel octet compris entre out et out + requiredSpace(), y compris ceux situés au-delà du pointeur de fin renvoyé.

Voir également requiredSpace.

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

Cette fonction a été introduite dans Qt 6.6.

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

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

Tente de déterminer l'encodage du code HTML de data en analysant les marqueurs d'ordre des octets (BOM) ou un spécificateur de jeu de caractères dans la balise meta HTML, puis renvoie un décodeur ( QStringDecoder ) correspondant à cet encodage. Si le décodeur renvoyé n'est pas valide, cela signifie que l'encodage 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 également isValid().

Indique au décodeur qu'aucune autre donnée ne sera transmise.

Peut également fournir des données provenant du contenu résiduel en attente de décodage. Lorsqu’il n’y a pas de données résiduelles à prendre en compte, le champ « error » de la réponse sera défini sur « NoError ».

Si « out » est fourni et n’est pas nul, il doit comporter un espace pouvant contenir jusqu’à maxlen caractères. Un nombre maximal de caractères de sortie résiduelle correspondant à cette valeur est écrit dans cet espace, la fin étant indiquée par le champ « next » de la valeur de retour. En règle générale, ces données résiduelles consistent en un caractère de remplacement par caractère d’entrée restant non converti.

Si tout le contenu résiduel a été fourni via ` out`, si ` out ` est ` nullptr`, ou s’il n’y a pas de données résiduelles, le décodeur est réinitialisé au retour de la fonction ` finalize()`. Sinon, les données restantes peuvent être récupérées ou ignorées par un nouvel appel à la fonction ` finalize()`.

Ces fonctions ont été introduites dans Qt 6.11.

Voir également hasError() et appendToBuffer().

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

Renvoie le nombre maximal d'unités de code UTF-16 nécessaires pour traiter des données encodées en inputLength.

Voir également appendToBuffer.