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
}

Documentation des fonctions membres

[static] QStringList QStringConverter::availableCodecs()

Renvoie une liste de noms de codecs pris en charge. Les noms renvoyés par cette fonction peuvent être transmis aux constructeurs de QStringEncoder et QStringDecoder pour créer un en- ou un décodeur pour le codec donné.

Cette fonction peut être utilisée pour obtenir une liste de codecs supplémentaires en plus des codecs standard. La prise en charge de codecs supplémentaires nécessite que Qt soit compilé avec la prise en charge de la bibliothèque ICU.

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

Renvoie l'encodage du contenu de data s'il peut être déterminé. expectedFirstCharacter peut être transmis en tant qu'indice supplémentaire pour aider à déterminer l'encodage.

L'option renvoyée est vide si l'encodage n'est pas clair.

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

Essaie 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. Si l'option est vide, le codage spécifié n'est pas pris en charge par QStringConverter. Si aucun encodage n'est détecté, la méthode renvoie Utf8.

Voir aussi QStringDecoder::decoderForHtml().

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

Convertit name en membre Encoding correspondant, s'il y en a un.

Si name n'est pas le nom d'un codec répertorié dans l'énumération Encoding, std::nullopt est renvoyé. Un tel nom peut néanmoins être accepté par le constructeur QStringConverter lorsque Qt est construit avec ICU, si ICU fournit un convertisseur avec le nom donné.

[noexcept] bool QStringConverter::hasError() const

Retourne true si une conversion n'a pas pu convertir correctement un caractère. Cela peut par exemple être déclenché par une séquence UTF-8 invalide ou lorsqu'un caractère ne peut pas être converti en raison de limitations dans l'encodage cible.

[noexcept] bool QStringConverter::isValid() const

Retourne true s'il s'agit d'un convertisseur de chaîne valide qui peut être utilisé pour encoder ou décoder du texte.

Les convertisseurs de chaînes construits par défaut ou les convertisseurs construits avec un nom non supporté ne sont pas valides.

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

Renvoie le nom canonique de l'encodage que cette QStringConverter peut encoder ou décoder. Retourne un nullptr si le convertisseur n'est pas valide. Le nom retourné est encodé en UTF-8.

Voir aussi isValid().

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

Renvoie le nom canonique de l'encodage e ou nullptr si e est une valeur invalide.

[noexcept] void QStringConverter::resetState()

Réinitialise l'état interne du convertisseur, en éliminant les erreurs potentielles ou les conversions partielles.