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
}

Dokumentation der Mitgliedsfunktionen

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

Erstellt eine Instanz von ` QStringConverter` mithilfe von `Move`.

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

Löscht die Instanz von „ QStringConverter “.

[static] QStringList QStringConverter::availableCodecs()

Gibt eine Liste der Namen der unterstützten Codecs zurück. Die von dieser Funktion zurückgegebenen Namen können an den Konstruktor von ` QStringEncoder` und ` QStringDecoder` übergeben werden, um einen Encoder oder Decoder für den angegebenen Codec zu erstellen.

Diese Funktion kann verwendet werden, um eine Liste weiterer Codecs zu erhalten, die über die Standard-Codecs hinausgehen. Die Unterstützung zusätzlicher Codecs setzt voraus, dass Qt mit Unterstützung für die ICU-Bibliothek kompiliert wurde.

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

Gibt die Kodierung für den Inhalt von data zurück, sofern diese ermittelt werden kann. expectedFirstCharacter kann als zusätzlicher Hinweis übergeben werden, um die Ermittlung der Kodierung zu erleichtern.

Das zurückgegebene Optional ist leer, wenn die Kodierung unklar ist.

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

Versucht, die Kodierung des HTML-Codes unter data zu ermitteln, indem nach führenden Byte-Order-Marks oder einem Zeichensatzangabe im HTML-Meta-Tag gesucht wird. Ist das optionale Argument leer, wird die angegebene Kodierung von QStringConverter nicht unterstützt. Wird keine Kodierung erkannt, gibt die Methode „Utf8“ zurück.

Siehe auch QStringDecoder::decoderForHtml().

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

Konvertieren Sie „ name “ in das entsprechende „ Encoding “-Element, sofern vorhanden.

Wenn „ name “ nicht der Name eines in der Aufzählung „Encoding“ aufgeführten Codecs ist, wird „ std::nullopt “ zurückgegeben. Ein solcher Name kann dennoch vom Konstruktor „ QStringConverter “ akzeptiert werden, wenn Qt mit ICU kompiliert wurde und ICU einen Konverter mit dem angegebenen Namen bereitstellt.

[noexcept] bool QStringConverter::hasError() const

Gibt „true“ zurück, wenn bei einer Konvertierung ein Zeichen nicht korrekt konvertiert werden konnte. Dies kann beispielsweise durch eine ungültige UTF-8-Sequenz ausgelöst werden oder wenn ein Zeichen aufgrund von Einschränkungen in der Zielkodierung nicht konvertiert werden kann.

[noexcept] bool QStringConverter::isValid() const

Gibt „true“ zurück, wenn es sich um einen gültigen Zeichenfolgenkonverter handelt, der zum Kodieren oder Dekodieren von Text verwendet werden kann.

Standardmäßig erstellte Zeichenfolgenkonverter oder Konverter, die mit einem nicht unterstützten Namen erstellt wurden, sind ungültig.

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

Gibt den kanonischen Namen der Kodierung zurück, die dieser QStringConverter kodieren oder dekodieren kann. Gibt einen nullptr zurück, wenn der Konverter ungültig ist. Der zurückgegebene Name ist UTF-8-kodiert.

Siehe auch isValid().

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

Gibt den kanonischen Namen für die Kodierung „ e “ oder „ nullptr “ zurück, wenn „ e “ ein ungültiger Wert ist.

[noexcept] void QStringConverter::resetState()

Setzt den internen Zustand des Wandlers zurück und löscht dabei mögliche Fehler oder unvollständige Umwandlungen.

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

Weist „ other “ dieser „ QStringConverter “-Instanz zu.