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

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

Crée par « move » une instance de ` QStringConverter`.

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

Supprime l'instance de ` QStringConverter`.

[static] QStringList QStringConverter::availableCodecs()

Renvoie une liste des noms des codecs pris en charge. Les noms renvoyés par cette fonction peuvent être transmis au constructeur de ` QStringEncoder` et ` QStringDecoder` afin de créer un encodeur ou un décodeur pour le codec spécifié.

Cette fonction peut être utilisée pour obtenir une liste de codecs supplémentaires, en plus de ceux standard. La prise en charge de ces codecs supplémentaires nécessite que Qt soit compilé avec 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 est possible de le déterminer. expectedFirstCharacter peut être transmis en tant qu'indication supplémentaire pour faciliter la détermination de l'encodage.

L'objet optionnel renvoyé est vide si l'encodage n'est pas clair.

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

Tente de déterminer l'encodage du code HTML de data en analysant les marqueurs d'ordre des octets (BOM) en début de fichier ou un spécificateur de jeu de caractères dans la balise meta HTML. Si le paramètre facultatif est vide, l'encodage spécifié n'est pas pris en charge par QStringConverter. Si aucun encodage n'est détecté, la méthode renvoie « Utf8 ».

Voir également QStringDecoder::decoderForHtml().

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

Convertir ` name ` en membre correspondant de ` Encoding `, s'il en existe un.

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

[noexcept] bool QStringConverter::hasError() const

Renvoie « true » si une conversion n'a pas pu convertir correctement un caractère. Cela peut par exemple se produire en cas de séquence UTF-8 non valide ou lorsqu'un caractère ne peut pas être converti en raison de limitations de l'encodage cible.

[noexcept] bool QStringConverter::isValid() const

Renvoie « true » s'il s'agit d'un convertisseur de chaînes valide pouvant être utilisé pour l'encodage ou le décodage de texte.

Les convertisseurs de chaînes créés par défaut ou ceux créés avec un nom non pris en charge ne sont pas valides.

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

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

Voir également 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 non valide.

[noexcept] void QStringConverter::resetState()

Réinitialise l'état interne du convertisseur, effaçant ainsi les éventuelles erreurs ou conversions partielles.

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

Cette opération attribue « other » à cette instance de « QStringConverter ».