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;

Dokumentation zu den Member-Funktionen

[protected] QTextCodec::QTextCodec()

Erstellt einen QTextCodec und weist ihm die höchste Priorität zu. Der QTextCodec sollte immer auf dem Heap erstellt werden (d. h. mit ` new`). Qt übernimmt die Verantwortung dafür und löscht ihn, wenn die Anwendung beendet wird.

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

Löscht die ` QTextCodec`. Beachten Sie, dass Sie Codecs nicht selbst löschen sollten: Sobald sie erstellt wurden, fallen sie in den Verantwortungsbereich von Qt.

Warnung: Diese Funktion ist nicht reentrant.

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

Unterklassen können eine Reihe von Aliasen für den betreffenden Codec zurückgeben.

Standard-Aliase für Codecs finden sich in der IANA-Datei zu Zeichensätzen und Kodierungen.

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

Gibt die Liste aller verfügbaren Codecs nach Namen sortiert zurück. Rufen Sie „ QTextCodec::codecForName()“ auf, um die „ QTextCodec “ für den jeweiligen Namen abzurufen.

Die Liste kann mehrere Einträge für denselben Codec enthalten, wenn der Codec Aliase hat.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch availableMibs(), name() und aliases().

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

Gibt die Liste der MIBs für alle verfügbaren Codecs zurück. Rufen Sie „ QTextCodec::codecForMib()“ auf, um die „ QTextCodec “ für die MIB abzurufen.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch availableCodecs() und mibEnum().

bool QTextCodec::canEncode(QChar ch) const

Gibt „ true “ zurück, wenn das Unicode-Zeichen „ ch “ mit diesem Codec vollständig kodiert werden kann; andernfalls wird „ false “ zurückgegeben.

bool QTextCodec::canEncode(QStringView s) const

Gibt „ true “ zurück, wenn die Unicode-Zeichenkette „ s “ mit diesem Codec vollständig kodiert werden kann; andernfalls wird „ false “ zurückgegeben.

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

s enthält die Zeichenkette, die auf ihre Kodierbarkeit geprüft wird.

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

Versucht, die Kodierung des bereitgestellten HTML-Ausschnitts im angegebenen Byte-Array zu ermitteln ( ba), indem das BOM (Byte Order Mark) und der Content-Type-Meta-Header überprüft werden, und gibt eine Instanz von ` QTextCodec ` zurück, die in der Lage ist, den HTML-Code in Unicode zu dekodieren. Kann der Codec anhand des bereitgestellten Inhalts nicht ermittelt werden, wird ` defaultCodec ` zurückgegeben.

Siehe auch codecForUtfText().

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

Versucht, die Kodierung des bereitgestellten HTML-Ausschnitts im angegebenen Byte-Array ba zu ermitteln, indem das BOM (Byte Order Mark) und der Content-Type-Meta-Header überprüft werden, und gibt eine QTextCodec -Instanz zurück, die in der Lage ist, den HTML-Code in Unicode zu dekodieren. Kann der Codec nicht ermittelt werden, gibt diese Überladung ein Latin-1- QTextCodec zurück.

[static] QTextCodec *QTextCodec::codecForLocale()

Gibt einen Zeiger auf den für diese Locale am besten geeigneten Codec zurück.

Der Codec wird aus ICU abgerufen, sofern dieses Backend verwendet wird; andernfalls kann er über eine betriebssystemspezifische API bezogen werden. Im letzteren Fall lautet der Name des Codecs möglicherweise „System“.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch ` setCodecForLocale()`.

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

Gibt das „ QTextCodec “ zurück, das dem „ MIBenum “ mib entspricht.

Hinweis: Diese Funktion ist threadsicher.

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

Durchsucht alle installierten „ QTextCodec “-Objekte und gibt dasjenige zurück, das am besten mit „ name “ übereinstimmt; dabei wird die Groß-/Kleinschreibung nicht berücksichtigt. Gibt „ nullptr “ zurück, wenn kein Codec gefunden wurde, der dem Namen „ name “ entspricht.

Hinweis: Diese Funktion ist threadsicher.

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

Durchsucht alle installierten „ QTextCodec “-Objekte und gibt dasjenige zurück, das am besten mit „ name “ übereinstimmt; dabei wird die Groß-/Kleinschreibung nicht berücksichtigt. Gibt „ nullptr “ zurück, wenn kein Codec gefunden wurde, der dem Namen „ name “ entspricht.

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

Versucht, die Kodierung des übergebenen Textabschnitts ba mithilfe des BOM (Byte Order Mark) zu ermitteln, und gibt eine QTextCodec -Instanz zurück, die den Text in Unicode dekodieren kann. Diese Funktion kann einen der folgenden Codecs erkennen:

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

Wenn der Codec anhand des bereitgestellten Inhalts nicht ermittelt werden kann, wird „ defaultCodec “ zurückgegeben.

Siehe auch codecForHtml().

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

Versucht, die Kodierung des übergebenen Textabschnitts ba anhand des BOM (Byte Order Mark) zu ermitteln, und gibt eine Instanz von ` QTextCodec ` zurück, mit der der Text in Unicode dekodiert werden kann. Diese Funktion kann einen der folgenden Kodecs erkennen:

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

Wenn der Codec anhand des bereitgestellten Inhalts nicht ermittelt werden kann, gibt diese Überladung einen Latin-1- QTextCodec zurück.

Siehe auch ` codecForHtml()`.

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

QTextCodec Unterklassen müssen diese Funktion neu implementieren.

Konvertiert die ersten number Zeichen aus dem Array input von Unicode in die Kodierung der Unterklasse und gibt das Ergebnis in einem QByteArray zurück.

state kann „ nullptr “ sein; in diesem Fall erfolgt die Konvertierung zustandslos und es sollten die Standardkonvertierungsregeln verwendet werden. Ist „ state “ nicht „ nullptr “, sollte der Codec den Zustand nach der Konvertierung in „ state “ speichern und die Mitglieder „ remainingChars “ und „ invalidChars “ der Struktur anpassen.

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

QTextCodec Unterklassen müssen diese Funktion neu implementieren.

Konvertiert die ersten len Zeichen von chars aus der Kodierung der Unterklasse in Unicode und gibt das Ergebnis in einem QString zurück.

state kann „ nullptr “ sein; in diesem Fall erfolgt die Konvertierung zustandslos und es sollten die Standardkonvertierungsregeln verwendet werden. Ist „ state “ nicht „ nullptr “, sollte der Codec den Zustand nach der Konvertierung in „ state “ speichern und die Mitglieder „ remainingChars “ und „ invalidChars “ der Struktur anpassen.

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

Konvertiert str von Unicode in die Kodierung dieses Codecs und gibt das Ergebnis in einem QByteArray zurück.

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

Konvertiert die ersten number Zeichen aus dem Array „ input “ von Unicode in die Kodierung dieses Codecs und gibt das Ergebnis in einem „ QByteArray “ zurück.

Der state des verwendeten Konverters wird aktualisiert.

QByteArray QTextCodec::fromUnicode(QStringView str) const

Konvertiert ` str ` von Unicode in die Kodierung dieses Codecs und gibt das Ergebnis in einem ` QByteArray` zurück.

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

Erstellt ein „ QTextDecoder “-Objekt mit einem angegebenen „ flags “, um „ char * “-Datenblöcke zu dekodieren und daraus Unicode-Datenblöcke zu erzeugen.

Der Aufrufer ist für das Löschen des zurückgegebenen Objekts verantwortlich.

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

Erstellt ein ` QTextEncoder ` mit einem angegebenen ` flags `, um Unicode-Datenblöcke als ` char * `-Daten zu kodieren.

Der Aufrufer ist dafür verantwortlich, das zurückgegebene Objekt zu löschen.

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

Unterklassen von ` QTextCodec ` müssen diese Funktion neu implementieren. Sie gibt den `MIBenum` zurück (weitere Informationen finden Sie in der IANA-Datei zu Zeichensätzen und Kodierungen ). Es ist wichtig, dass jede Unterklasse von ` QTextCodec ` für diese Funktion den korrekten, eindeutigen Wert zurückgibt.

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

QTextCodec Unterklassen müssen diese Funktion neu implementieren. Sie gibt den Namen der von der Unterklasse unterstützten Kodierung zurück.

Ist der Codec als Zeichensatz in der IANA-Zeichensatz-Kodierungsdatei registriert, sollte diese Methode den bevorzugten MIME-Namen für den Codec zurückgeben, sofern dieser definiert ist; andernfalls seinen Namen.

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

Setzen Sie den Codec auf „ c “; dieser Wert wird von „ codecForLocale()“ zurückgegeben. Wenn „ c “ gleich „ nullptr “ ist, wird der Codec auf den Standardwert zurückgesetzt.

Dies kann für einige Anwendungen erforderlich sein, die ihren eigenen Mechanismus zur Einstellung der Locale verwenden möchten.

Warnung: Diese Funktion ist nicht reentrant.

Siehe auch ` codecForLocale()`.

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

Konvertiert a aus der Kodierung dieses Codecs in Unicode und gibt das Ergebnis in einem QString zurück.

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

Konvertiert die ersten size Zeichen aus dem input von der Kodierung dieses Codecs in Unicode und gibt das Ergebnis in einem QString zurück.

Der state des verwendeten Konverters wird aktualisiert.

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

chars enthält die Quellzeichen.