QTextCodec Class

QByteArray encodedString = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QString string = codec->toUnicode(encodedString);

QString string = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QByteArray encodedString = codec->fromUnicode(string);

QTextCodec *codec = QTextCodec::codecForName("Shift-JIS");
QTextDecoder *decoder = codec->makeDecoder();

QString string;
while (new_data_available()) {
    QByteArray chunk = get_new_data();
    string += decoder->toUnicode(chunk);
}
delete decoder;

Documentation sur les fonctions membres

[protected] QTextCodec::QTextCodec()

Crée un objet `QTextCodec` et lui attribue la priorité la plus élevée. L'objet `QTextCodec` doit toujours être créé sur le tas (c'est-à-dire avec ` new`). Qt en prend la propriété et le supprimera à la fermeture de l'application.

[virtual noexcept protected] QTextCodec::~QTextCodec()

Supprime l'QTextCodec. Notez que vous ne devez pas supprimer vous-même les codecs : une fois créés, ils relèvent de la responsabilité de Qt.

Avertissement : cette fonction n'est pas réentrante.

[virtual] QList<QByteArray> QTextCodec::aliases() const

Les sous-classes peuvent renvoyer plusieurs alias pour le codec en question.

Les alias standard des codecs figurent dans le fichier d'encodage des jeux de caractères de l'IANA.

[static] QList<QByteArray> QTextCodec::availableCodecs()

Renvoie la liste de tous les codecs disponibles, classés par nom. Appelez la fonction ` QTextCodec::codecForName()` pour obtenir l'QTextCodec s relatives à un nom donné.

La liste peut contenir plusieurs occurrences d'un même codec si celui-ci possède des alias.

Remarque : cette fonction est thread-safe.

Voir également availableMibs(), name() et aliases().

[static] QList<int> QTextCodec::availableMibs()

Renvoie la liste des MIB pour tous les codecs disponibles. Appelez la fonction QTextCodec::codecForMib() pour obtenir l'QTextCodec s relatives à la MIB.

Remarque : cette fonction est thread-safe.

Voir également availableCodecs() et mibEnum().

bool QTextCodec::canEncode(QChar ch) const

Renvoie « true » si le caractère Unicode ch peut être entièrement encodé avec ce codec ; sinon, renvoie « false ».

bool QTextCodec::canEncode(QStringView s) const

Renvoie « true » si la chaîne Unicode « s » peut être entièrement encodée avec ce codec ; sinon, renvoie « false ».

bool QTextCodec::canEncode(const QString &s) const

s contient la chaîne dont on vérifie si elle peut être encodée.

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba, QTextCodec *defaultCodec)

Tente de détecter l'encodage de l'extrait de code HTML fourni dans le tableau d'octets donné, ba, en vérifiant le BOM (Byte Order Mark) et l'en-tête méta « content-type », puis renvoie une instance de ` QTextCodec ` capable de décoder le code HTML en Unicode. Si le codec ne peut pas être détecté à partir du contenu fourni, la valeur defaultCodec est renvoyée.

Voir également codecForUtfText().

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba)

Tente de détecter l'encodage de l'extrait de code HTML fourni dans le tableau d'octets donné, ba, en vérifiant le BOM (Byte Order Mark) et l'en-tête meta « content-type », puis renvoie une instance de QTextCodec capable de décoder le code HTML en Unicode. Si le codec ne peut pas être détecté, cette surcharge renvoie une instance de Latin-1 QTextCodec.

[static] QTextCodec *QTextCodec::codecForLocale()

Renvoie un pointeur vers le codec le mieux adapté à cette configuration régionale.

Le codec sera récupéré depuis ICU lorsque ce backend est utilisé ; sinon, il pourra être obtenu via une API spécifique au système d'exploitation. Dans ce dernier cas, le nom du codec peut être « System ».

Remarque : cette fonction est thread-safe.

Voir également setCodecForLocale().

[static] QTextCodec *QTextCodec::codecForMib(int mib)

Renvoie l'QTextCodec qui correspond à l'MIBenum mib .

Remarque : cette fonction est thread-safe.

[static] QTextCodec *QTextCodec::codecForName(const QByteArray &name)

Recherche parmi tous les objets « QTextCodec » installés et renvoie celui qui correspond le mieux à « name » ; la correspondance ne tient pas compte de la casse. Renvoie « nullptr » si aucun codec correspondant au nom « name » n’a pu être trouvé.

Remarque : cette fonction est thread-safe.

[static] QTextCodec *QTextCodec::codecForName(const char *name)

Recherche parmi tous les objets installés de type « QTextCodec » et renvoie celui qui correspond le mieux à « name » ; la correspondance ne tient pas compte de la casse. Renvoie « nullptr » si aucun codec correspondant au nom « name » n'a pu être trouvé.

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba, QTextCodec *defaultCodec)

Tente de détecter l'encodage de l'extrait fourni ba à l'aide du BOM (Byte Order Mark) et renvoie une instance de ` QTextCodec ` capable de décoder le texte en Unicode. Cette fonction peut détecter l'un des codages suivants :

• UTF-32 Little Endian
• UTF-32 Big Endian
• UTF-16 Little Endian
• UTF-16 Big Endian
• UTF-8

Si le codec ne peut pas être détecté à partir du contenu fourni, la valeur « defaultCodec » est renvoyée.

Voir aussi codecForHtml().

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba)

Tente de détecter l'encodage de l'extrait fourni ba à l'aide du BOM (Byte Order Mark) et renvoie une instance de ` QTextCodec ` capable de décoder le texte au format Unicode. Cette fonction peut détecter l'un des codages suivants :

• UTF-32 Little Endian
• UTF-32 Big Endian
• UTF-16 Little Endian
• UTF-16 Big Endian
• UTF-8

Si le codec ne peut pas être détecté à partir du contenu fourni, cette surcharge renvoie un QTextCodec au format Latin-1.

Voir aussi codecForHtml().

[pure virtual protected] QByteArray QTextCodec::convertFromUnicode(const QChar *input, int number, int *state) const

QTextCodec Les sous-classes doivent réimplémenter cette fonction.

Convertit la première number de caractères du tableau ` input ` du format Unicode vers l'encodage de la sous-classe, et renvoie le résultat dans un ` QByteArray`.

state peut être de type ` nullptr `, auquel cas la conversion est sans état et les règles de conversion par défaut doivent être utilisées. Si ` state ` n’est pas de type ` nullptr`, le codec doit enregistrer l’état après la conversion dans ` state`, puis ajuster les membres ` remainingChars ` et ` invalidChars ` de la structure.

[pure virtual protected] QString QTextCodec::convertToUnicode(const char *chars, int len, int *state) const

QTextCodec Les sous-classes doivent réimplémenter cette fonction.

Convertit les premiers len caractères de chars de l'encodage de la sous-classe vers Unicode, et renvoie le résultat dans un QString.

state peut être de type ` nullptr`, auquel cas la conversion est sans état et les règles de conversion par défaut doivent être utilisées. Si ` state ` n’est pas de type ` nullptr`, le codec doit enregistrer l’état après la conversion dans ` state`, puis ajuster les membres ` remainingChars ` et ` invalidChars ` de la structure.

QByteArray QTextCodec::fromUnicode(const QString &str) const

Convertit str de l'Unicode vers l'encodage de ce codec, puis renvoie le résultat dans un objet QByteArray.

QByteArray QTextCodec::fromUnicode(const QChar *input, int number, int *state = nullptr) const

Convertit les premiers number de caractères du tableau ` input ` du format Unicode vers l'encodage de ce codec, puis renvoie le résultat dans un objet ` QByteArray`.

L'state du convertisseur utilisé est mise à jour.

QByteArray QTextCodec::fromUnicode(QStringView str) const

Convertit str de l'Unicode vers l'encodage de ce codec, puis renvoie le résultat dans un QByteArray.

QTextDecoder *QTextCodec::makeDecoder(int flags = DefaultConversion) const

Crée un objet ` QTextDecoder ` avec une ` flags ` spécifiée afin de décoder des blocs de données au format « char * » pour générer des blocs de données Unicode.

L'appelant est chargé de supprimer l'objet renvoyé.

QTextEncoder *QTextCodec::makeEncoder(int flags = DefaultConversion) const

Crée un objet ` QTextEncoder ` avec une ` flags ` spécifiée afin d'encoder des blocs de données Unicode sous forme de données « char * ».

L'appelant est chargé de supprimer l'objet renvoyé.

[pure virtual] int QTextCodec::mibEnum() const

Les sous-classes de ` QTextCodec ` doivent réimplémenter cette fonction. Elle renvoie un `MIBenum` (voir le fichier d'encodage des jeux de caractères de l'IANA pour plus d'informations). Il est important que chaque sous-classe de ` QTextCodec ` renvoie la valeur unique correcte pour cette fonction.

[pure virtual] QByteArray QTextCodec::name() const

QTextCodec Les sous-classes doivent réimplémenter cette fonction. Elle renvoie le nom de l'encodage pris en charge par la sous-classe.

Si le codec est enregistré en tant que jeu de caractères dans le fichier d'encodage des jeux de caractères de l'IANA, cette méthode doit renvoyer le nom MIME préféré du codec s'il est défini, sinon son nom.

[static] void QTextCodec::setCodecForLocale(QTextCodec *c)

Définissez le codec sur c; cette valeur sera renvoyée par la fonction codecForLocale(). Si c est égal à nullptr, le codec est réinitialisé à sa valeur par défaut.

Cela peut s'avérer nécessaire pour certaines applications qui souhaitent utiliser leur propre mécanisme de configuration des paramètres régionaux.

Avertissement : cette fonction n’est pas réentrante.

Voir également codecForLocale().

QString QTextCodec::toUnicode(const QByteArray &a) const

Convertit a de l'encodage de ce codec vers Unicode, et renvoie le résultat dans un objet de type QString.

QString QTextCodec::toUnicode(const char *input, int size, int *state = nullptr) const

Convertit les premiers caractères de type « size » issus de l'input, de l'encodage de ce codec vers Unicode, puis renvoie le résultat dans un objet de type « QString ».

L'state du convertisseur utilisé est mise à jour.

QString QTextCodec::toUnicode(const char *chars) const

chars contient les caractères de la chaîne source.