QStringDecoder Class

Documentación de las funciones miembro

[constexpr noexcept] QStringDecoder::QStringDecoder()

Por defecto construye un decodificador. El decodificador por defecto no es válido, y no se puede utilizar para convertir texto.

[explicit] QStringDecoder::QStringDecoder(QAnyStringView name, QStringConverter::Flags flags = Flag::Default)

Crea un objeto decodificador usando name y flags. Si name no es el nombre de una codificación conocida se creará un conversor inválido.

Véase también isValid().

[explicit constexpr] QStringDecoder::QStringDecoder(QStringConverter::Encoding encoding, QStringConverter::Flags flags = Flag::Default)

Crea un objeto decodificador utilizando encoding y flags.

QChar *QStringDecoder::appendToBuffer(QChar *out, QByteArrayView in)

Decodifica la secuencia de bytes vista por in y escribe el resultado decodificado en el buffer comenzando en out. Devuelve un puntero al final de los datos escritos.

out debe ser lo suficientemente grande como para poder contener todos los datos descodificados. Utilice requiredSpace para determinar el tamaño máximo necesario para descodificar un búfer de datos codificados de in.size() bytes. Esta función puede escribir en cualquier byte entre out y out + requiredSpace(), incluidos los que están más allá del puntero final devuelto.

Véase también requiredSpace.

[since 6.6] char16_t *QStringDecoder::appendToBuffer(char16_t *out, QByteArrayView in)

Esta función se introdujo en Qt 6.6.

[static] QStringDecoder QStringDecoder::decoderForHtml(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 y devuelve un QStringDecoder que coincide con la codificación. Si el decodificador devuelto no es válido, la codificación especificada no está soportada por QStringConverter. Si no se detecta ninguna codificación, el método devuelve un descodificador para Utf8.

Véase también isValid().

Señala al descodificador que no llegarán más datos.

También puede proporcionar datos de contenido residual que estaba pendiente de descodificación. Cuando no haya datos residuales que contabilizar, el campo error de la devolución se establecerá en NoError.

Si se suministra out y no es nulo, debe tener espacio en el que se pueden escribir hasta maxlen caracteres. Hasta este número de caracteres de salida residual se escriben en este espacio, con el final indicado por el campo next del valor de retorno. Normalmente, estos datos residuales consistirán en un carácter de sustitución por cada carácter de entrada restante no convertido.

Si todo el contenido residual se ha entregado a través de out, si out es nullptr, o si no hay datos residuales, el descodificador se reinicia a la vuelta de finalize(). En caso contrario, los datos restantes pueden recuperarse o descartarse mediante una nueva llamada a finalize().

Estas funciones se introdujeron en Qt 6.11.

Véase también hasError() y appendToBuffer().

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

Devuelve la cantidad máxima de unidades de código UTF-16 necesarias para poder procesar los datos codificados en inputLength.

Véase también appendToBuffer.

Convierte ba y devuelve una estructura convertible implícitamente a QString.

QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
auto data = toUtf16(encodedString); // data's type is QStringDecoder::EncodedData<const QByteArray &>
QString string = toUtf16(encodedString); // Implicit conversion to QString

// Here you have to cast "data" to QString
auto func = [&]() { return !toUtf16.hasError() ? QString(data) : u"foo"_s; };