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
}

Documentación de las funciones miembro

[static] QStringList QStringConverter::availableCodecs()

Devuelve una lista de nombres de códecs compatibles. Los nombres devueltos por esta función se pueden pasar al constructor de QStringEncoder's y QStringDecoder's para crear un en- o decodificador para el códec dado.

Esta función puede utilizarse para obtener una lista de códecs adicionales a los estándar. El soporte para códecs adicionales requiere que Qt esté compilado con soporte para la librería ICU.

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

Devuelve la codificación del contenido de data si se puede determinar. expectedFirstCharacter se puede pasar como una pista adicional para ayudar a determinar la codificación.

El opcional devuelto está vacío, si la codificación no está clara.

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

Intenta determinar la codificación del HTML en data fijándose en las marcas de orden de bytes iniciales o en un especificador charset de la metaetiqueta HTML. Si el opcional está vacío, la codificación especificada no es compatible con QStringConverter. Si no se detecta ninguna codificación, el método devuelve Utf8.

Véase también QStringDecoder::decoderForHtml().

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

Convierte name al miembro Encoding correspondiente, si existe.

Si name no es el nombre de un códec incluido en la enumeración Encoding, se devuelve std::nullopt. Dicho nombre puede, no obstante, ser aceptado por el constructor QStringConverter cuando Qt se construye con ICU, si ICU proporciona un convertidor con el nombre dado.

[noexcept] bool QStringConverter::hasError() const

Devuelve true si una conversión no pudo convertir correctamente un carácter. Esto puede ocurrir, por ejemplo, si la secuencia UTF-8 no es válida o si un carácter no se puede convertir debido a limitaciones en la codificación de destino.

[noexcept] bool QStringConverter::isValid() const

Devuelve true si se trata de un conversor de cadenas válido que puede utilizarse para codificar o descodificar texto.

Los convertidores de cadenas construidos por defecto o los convertidores construidos con un nombre no admitido no son válidos.

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

Devuelve el nombre canónico de la codificación que este QStringConverter puede codificar o descodificar. Devuelve un nullptr si el convertidor no es válido. El nombre devuelto está codificado en UTF-8.

Véase también isValid().

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

Devuelve el nombre canónico para la codificación e o nullptr si e es un valor inválido.

[noexcept] void QStringConverter::resetState()

Restablece el estado interno del convertidor, eliminando posibles errores o conversiones parciales.