QStringDecoder Class
La clase QStringDecoder ofrece un decodificador de texto basado en estados. Más información...
| Encabezado: | #include <QStringDecoder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredan: | QStringConverter |
- Lista de todos los miembros, incluidos los heredados
- QStringDecoder forma parte de las clases para datos de cadena.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
Funciones públicas
| QStringDecoder() | |
| QStringDecoder(QAnyStringView name, QStringConverter::Flags flags = Flag::Default) | |
| QStringDecoder(QStringConverter::Encoding encoding, QStringConverter::Flags flags = Flag::Default) | |
| QChar * | appendToBuffer(QChar *out, QByteArrayView in) |
(since 6.6) char16_t * | appendToBuffer(char16_t *out, QByteArrayView in) |
| QStringDecoder::EncodedData<QByteArrayView> | decode(QByteArrayView ba) |
| QStringDecoder::EncodedData<const QByteArray &> | decode(const QByteArray &ba) |
(since 6.11) QStringDecoder::FinalizeResult | finalize() |
(since 6.11) QStringDecoder::FinalizeResultQChar | finalize(QChar *out, qsizetype maxlen) |
(since 6.11) QStringDecoder::FinalizeResult | finalize(char16_t *out, qsizetype maxlen) |
| qsizetype | requiredSpace(qsizetype inputLength) const |
| QStringDecoder::EncodedData<QByteArrayView> | operator()(QByteArrayView ba) |
| QStringDecoder::EncodedData<const QByteArray &> | operator()(const QByteArray &ba) |
Miembros públicos estáticos
| QStringDecoder | decoderForHtml(QByteArrayView data) |
Descripción detallada
Un decodificador de texto convierte un texto en formato codificado —que utiliza una codificación específica— a la representación interna de Qt.
La conversión de datos codificados a un objeto ` QString ` se puede realizar utilizando el siguiente código:
QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
QString string = toUtf16(encodedString);El decodificador recuerda cualquier estado necesario entre llamadas, por lo que convertir datos recibidos en fragmentos —por ejemplo, al recibirlos a través de una red— resulta igual de sencillo, llamando al decodificador cada vez que haya nuevos datos disponibles:
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
}El objeto QStringDecoder mantiene el estado entre fragmentos y, por lo tanto, funciona correctamente incluso si los fragmentos se dividen en medio de una secuencia de caracteres multibyte.
Los objetos QStringDecoder no se pueden copiar debido a su estado interno, pero sí se pueden mover.
Véase también QStringConverter y QStringEncoder.
Documentación sobre los tipos de miembros
[alias] QStringDecoder::FinalizeResult
Se trata de un alias para QStringConverter::FinalizeResultChar<char16_t>.
[alias] QStringDecoder::FinalizeResultQChar
Este es un alias de QStringConverter::FinalizeResultChar<QChar>.
Documentación de funciones de miembro
[constexpr noexcept] QStringDecoder::QStringDecoder()
Por defecto, se crea 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 utilizando name y flags. Si name no es el nombre de una codificación conocida, se creará un conversor no válido.
Nota: En las versiones de Qt anteriores a la 6.8, esta función solo aceptaba un ` const char *`, del que se esperaba que estuviera codificado en UTF-8.
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 leída por in y escribe el resultado decodificado en el búfer a partir de out. Devuelve un puntero al final de los datos escritos.
out Debe ser lo suficientemente grande como para poder almacenar todos los datos descodificados. Utiliza requiredSpace para determinar los requisitos de tamaño máximo necesarios para descodificar un búfer de datos codificados de in.size() bytes. Esta función puede escribir en cualquier byte comprendido entre out y out + requiredSpace(), incluidos aquellos que se encuentren 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 es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
QStringDecoder::EncodedData<QByteArrayView> QStringDecoder::decode(QByteArrayView ba)
QStringDecoder::EncodedData<QByteArrayView> QStringDecoder::operator()(QByteArrayView ba)
QStringDecoder::EncodedData<const QByteArray &> QStringDecoder::decode(const QByteArray &ba)
QStringDecoder::EncodedData<const QByteArray &> QStringDecoder::operator()(const QByteArray &ba)
Convierte ` ba ` y devuelve una estructura que se puede convertir 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; };[static] QStringDecoder QStringDecoder::decoderForHtml(QByteArrayView data)
Intenta determinar la codificación del HTML en data analizando las marcas de orden de bytes iniciales o un especificador de juego de caracteres en la etiqueta meta HTML, y devuelve un ` QStringDecoder ` que se corresponde con dicha codificación. Si el decodificador devuelto no es válido, significa que QStringConverter no admite la codificación especificada. Si no se detecta ninguna codificación, el método devuelve un decodificador para Utf8.
Véase también isValid().
[since 6.11] QStringDecoder::FinalizeResult QStringDecoder::finalize()
[since 6.11] QStringDecoder::FinalizeResultQChar QStringDecoder::finalize(QChar *out, qsizetype maxlen)
[since 6.11] QStringDecoder::FinalizeResult QStringDecoder::finalize(char16_t *out, qsizetype maxlen)
Indica al decodificador que no llegarán más datos.
También puede proporcionar datos procedentes de contenido residual que estaba pendiente de decodificación. Cuando no haya datos residuales que tener en cuenta, el campo « error » de la respuesta se establecerá en « NoError ».
Si se proporciona out y no es nulo, debe disponer de espacio en el que se puedan escribir hasta maxlen caracteres. En este espacio se escriben hasta ese número de caracteres de salida residual, indicándose el final mediante 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 sin convertir.
Si todo el contenido residual se ha entregado mediante out, si out es nullptr o si no hay datos residuales, el decodificador se reinicia al regresar de finalize(). De lo 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 datos codificados c inputLength.
Véase también appendToBuffer.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.