QBinaryJson Namespace
Contiene funciones para convertir QJsonDocument al formato binario JSON y viceversa. Más información...
| Encabezado: | #include <QBinaryJson> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
Tipos
| enum | DataValidation { Validate, BypassValidation } |
Funciones
| QJsonDocument | fromBinaryData(const QByteArray &data, QBinaryJson::DataValidation validation = Validate) |
| QJsonDocument | fromRawData(const char *data, int size, QBinaryJson::DataValidation validation = Validate) |
| QByteArray | toBinaryData(const QJsonDocument &document) |
Descripción detallada
Este espacio de nombres proporciona funciones de utilidad para mantener la compatibilidad con código antiguo, que utiliza el formato binario JSON para serializar JSON. Los tipos JSON de Qt se pueden convertir a tipos CBOR de Qt, que a su vez se pueden serializar al formato binario CBOR y viceversa.
Documentación de tipos
enum QBinaryJson::DataValidation
Esta enumeración se utiliza para indicar a QJsonDocument si debe validar los datos binarios al convertirlos a un objeto de tipo « QJsonDocument » mediante fromBinaryData() o fromRawData().
| Constante | Valor | Descripción |
|---|---|---|
QBinaryJson::Validate | 0 | Valida los datos antes de utilizarlos. Es el valor predeterminado. |
QBinaryJson::BypassValidation | 1 | Omite la validación de datos. Úsala solo si has recibido los datos de una fuente fiable y sabes que son válidos, ya que el uso de datos no válidos puede provocar un fallo en la aplicación. |
Documentación de la función
QJsonDocument QBinaryJson::fromBinaryData(const QByteArray &data, QBinaryJson::DataValidation validation = Validate)
Crea un objeto ` QJsonDocument ` a partir de ` data`.
validation Determina si se comprueba la validez de los datos antes de utilizarlos. Por defecto, los datos se validan. Si el data no es válido, el método devuelve un documento nulo.
Nota: La codificación JSON binaria solo se mantiene por motivos de compatibilidad con versiones anteriores. No está documentada y presenta restricciones en cuanto al tamaño máximo de los documentos JSON que se pueden codificar. Los tipos JSON de Qt se pueden convertir a tipos CBOR de Qt, que a su vez se pueden serializar al formato binario CBOR y viceversa. El formato CBOR es una representación binaria bien definida y menos restrictiva para un superconjunto de JSON.
Véase también toBinaryData(), fromRawData(), DataValidation y QCborValue.
QJsonDocument QBinaryJson::fromRawData(const char *data, int size, QBinaryJson::DataValidation validation = Validate)
Crea un objeto ` QJsonDocument ` que utiliza los primeros ` size ` bytes de ` data`. Se da por hecho que ` data ` contiene un documento JSON codificado en binario. El documento creado no asume la propiedad de ` data`. Los datos se copian en una estructura de datos diferente, y los datos originales pueden eliminarse o modificarse posteriormente.
data Debe estar alineado con un límite de 4 bytes.
validation Determina si se comprueba la validez de los datos antes de utilizarlos. Por defecto, los datos se validan. Si data no es válido, el método devuelve un documento nulo.
Devuelve un ` QJsonDocument ` que representa los datos.
Nota: La codificación JSON binaria solo se mantiene por motivos de compatibilidad con versiones anteriores. No está documentada y es restrictiva en cuanto al tamaño máximo de los documentos JSON que se pueden codificar. Los tipos JSON de Qt se pueden convertir a tipos CBOR de Qt, que a su vez se pueden serializar al formato binario CBOR y viceversa. El formato CBOR es una representación binaria bien definida y menos restrictiva para un superconjunto de JSON.
Nota: Antes de Qt 5.15, el llamante debía garantizar que data no se eliminara ni modificara mientras QJsonDocument, QJsonObject o QJsonArray siguieran haciendo referencia a los datos. A partir de Qt 5.15, esto ya no es necesario.
Véase también toRawData(), fromBinaryData(), DataValidation y QCborValue.
QByteArray QBinaryJson::toBinaryData(const QJsonDocument &document)
Devuelve una representación binaria de ` document`.
La representación binaria es también el formato nativo utilizado internamente en Qt, y resulta muy eficiente y rápido a la hora de convertir de y hacia este formato.
El formato binario se puede almacenar en disco e intercambiar con otras aplicaciones u ordenadores. Se puede utilizar ` fromBinaryData()` para volver a convertirlo en un documento JSON.
Nota: La codificación JSON binaria solo se mantiene por motivos de compatibilidad con versiones anteriores. No está documentada y presenta restricciones en cuanto al tamaño máximo de los documentos JSON que se pueden codificar. Los tipos JSON de Qt se pueden convertir a tipos CBOR de Qt, que a su vez se pueden serializar al formato binario CBOR y viceversa. El formato CBOR es una representación binaria bien definida y menos restrictiva para un superconjunto de JSON.
Véase también fromBinaryData() y QCborValue.
© 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.