En esta página

Compatibilidad con CBOR en Qt

Qt ofrece compatibilidad para gestionar datos CBOR. CBOR es un formato binario para almacenar datos que cuenta con un superconjunto de los tipos disponibles en JSON, pero que resulta más compacto.

La compatibilidad con CBOR en Qt ofrece una API de C++ fácil de usar para analizar, modificar y guardar datos CBOR.

Se puede encontrar más información sobre el formato de datos CBOR en el RFC 7049.

Descripción general

CBOR es un formato para almacenar datos estructurados. Cuenta con tres grupos de tipos integrados:

  • Tipos básicos: enteros, punto flotante, booleano, nulo, etc.
  • Tipos similares a cadenas: cadenas y matrices de bytes
  • Contenedores: matrices y mapas

Además, CBOR puede añadir una «etiqueta» para ampliar el significado del tipo. Los tipos contenedor pueden contener tipos básicos, tipos similares a cadenas y contenedores.

Las clases CBOR

La clase QCborValue

La clase ` QCborValue ` representa cualquier tipo CBOR. También cuenta con una API sencilla para leer y escribir en objetos ` QCborStreamReader ` y ` QCborStreamWriter `, así como para manipular dichos objetos en memoria, con la ayuda de ` QCborArray ` y ` QCborMap`. La API de CborValue es una versión simplificada del tipo de datos CBOR completo y siempre representa todos los enteros como qint64 y todos los números de coma flotante como double. Esto significa que QCborValue no puede representar valores enteros CBOR fuera del rango de qint64 (-2^63 a 2^63-1). Al crear un flujo CBOR, se puede configurar QCborValue::toCbor() para que intente escribir las representaciones de coma flotante de precisión simple y media más cortas.

La clase QCborArray

La clase ` QCborArray ` se utiliza para almacenar una matriz de objetos ` QCborValue `. Un objeto ` QCborValue ` puede contener un objeto ` QCborArray `. Dispone de funciones para convertir entre ` QVariantList`, ` QStringList` y ` QJsonArray`.

La clase QCborMap

La clase « QCborMap » se utiliza para almacenar un mapa de objetos « QCborValue ». Un objeto « QCborValue » puede contener un objeto « QCborMap ». Dispone de funciones para convertir entre « QVariantMap », « QVariantHash » y « QJsonObject », pero puede tener claves de cualquier tipo, no solo « QString ».

La clase QCborStreamReader

La clase ` QCborStreamReader ` es una API de bajo nivel para leer datos CBOR desde un ` QIODevice`, un ` QByteArray` o un puntero a la memoria. Cuenta con una API similar a la de la clase ` QXmlStreamReader `.

La clase QCborStreamWriter

La clase ` QCborStreamWriter ` es una API de bajo nivel para escribir datos CBOR en un ` QIODevice ` o en un ` QByteArray`. Su API es similar a la de la clase ` QXmlStreamWriter `.

Véase también Análisis y visualización de datos CBOR, Convertidor de serialización y Guardar y cargar una partida.

QCborArray

Se utiliza para almacenar una matriz de elementos CBOR

QCborArray::ConstIterator

La clase `QCborArray::ConstIterator` proporciona un iterador const al estilo STL para `QCborArray`

QCborArray::Iterator

La clase `QCborArray::Iterator` proporciona un iterador no const al estilo STL para `QCborArray`

QCborMap

Se utiliza para contener un contenedor asociativo representable en CBOR

QCborMap::ConstIterator

La clase `QCborMap::ConstIterator` proporciona un iterador const al estilo STL para `QCborMap`

QCborMap::Iterator

La clase `QCborMap::Iterator` proporciona un iterador no constante al estilo STL para `QCborMap`

QCborParserError

Utilizado por QCborValue para notificar un error de análisis

QCborStreamReader

Decodificador simple de flujos CBOR, que opera tanto con un `QByteArray` como con un `QIODevice`

QCborStreamWriter

Codificador CBOR sencillo que opera sobre un flujo unidireccional

QCborValue

Encapsula un valor en CBOR

© 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.