<QtCborCommon>

El archivo de cabecera <QtCborCommon> contiene definiciones comunes tanto a las clases de streaming (QCborStreamReader y QCborStreamWriter) como a QCborValue. Más...

Header: #include <QtCborCommon>

Tipos

enum class QCborKnownTags { DateTimeString, UnixTime_t, PositiveBignum, NegativeBignum, Decimal, …, Signature }
enum class QCborSimpleType { False, True, Null, Undefined }
enum class QCborTag { }

Descripción detallada

Véase también QCborError.

Documentación del tipo

enum class QCborKnownTags

Esta enumeración contiene una lista de etiquetas CBOR conocidas en el momento de la implementación de Qt. Esta lista no pretende ser exhaustiva y solo incluye etiquetas que están respaldadas por un RFC o que utiliza específicamente la implementación de Qt.

La lista oficial la mantiene la IANA en el registro de etiquetas CBOR.

ConstanteValorDescripción
QCborKnownTags::DateTimeString0Una cadena de fecha y hora, formateada según la RFC 3339, tal y como se especifica en la RFC 4287. Es el mismo formato que el de Qt::ISODate y Qt::ISODateWithMs.
QCborKnownTags::UnixTime_t1Una representación numérica de los segundos transcurridos desde el 1 de enero de 1970 a las 00:00Z.
QCborKnownTags::PositiveBignum2Un número positivo de longitud arbitraria, codificado como una matriz de bytes en el orden de bytes de red. Por ejemplo, el número264 se representa mediante una matriz de bytes que contiene el valor de byte 0x01 seguido de 8 bytes nulos.
QCborKnownTags::NegativeBignum3Un número negativo de longitud arbitraria, codificado como el valor absoluto de dicho número menos uno. Por ejemplo, una matriz de bytes que contenga el valor de byte 0x02 seguido de 8 bytes nulos representa el número-265 - 1.
QCborKnownTags::Decimal4Una fracción decimal, codificada como una matriz de dos enteros: el primero es el exponente de la potencia de 10, y el segundo, la mantisa entera. El valor 273,15 se codificaría como la matriz [-2, 27315].
QCborKnownTags::Bigfloat5Similar a «Decimal», pero el exponente es una potencia de 2.
QCborKnownTags::COSE_Encrypt016Un mapa « Encrypt0 » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR).
QCborKnownTags::COSE_Mac017Una asignación « Mac0 » tal y como se especifica en la RFC 8152 (Firma y cifrado de objetos CBOR).
QCborKnownTags::COSE_Sign118Un mapa « Sign1 » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR).
QCborKnownTags::ExpectedBase64url21Indica que la matriz de bytes debe codificarse utilizando Base64url si el flujo se convierte a JSON.
QCborKnownTags::ExpectedBase6422Indica que la matriz de bytes debe codificarse utilizando Base64 si el flujo se convierte a JSON.
QCborKnownTags::ExpectedBase1623Indica que la matriz de bytes debe codificarse utilizando Base16 (hexadecimal) si el flujo se convierte a JSON.
QCborKnownTags::EncodedCbor24Indica que la matriz de bytes contiene un flujo CBOR.
QCborKnownTags::Url32Indica que la cadena contiene una URL.
QCborKnownTags::Base64url33Indica que la cadena contiene datos codificados mediante Base64url.
QCborKnownTags::Base6434Indica que la cadena contiene datos codificados mediante Base64.
QCborKnownTags::RegularExpression35Indica que la cadena contiene un patrón de expresión regular compatible con Perl.
QCborKnownTags::MimeMessage36Indica que la cadena contiene un mensaje MIME (según RFC 2045).
QCborKnownTags::Uuid37Indica que la matriz de bytes contiene un UUID.
QCborKnownTags::COSE_Encrypt96Un mapa « Encrypt » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR).
QCborKnownTags::COSE_Mac97Un mapa « Mac » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR).
QCborKnownTags::COSE_Sign98Un mapa « Sign », tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR).
QCborKnownTags::Signature55799No hay cambios en la interpretación; esta etiqueta puede utilizarse como la etiqueta más externa en un flujo CBOR a modo de encabezado de archivo.

QCborValue interpreta las siguientes etiquetas durante la decodificación y generará objetos con tipos Qt extendidos; además, utilizará dichas etiquetas al codificar los mismos tipos extendidos.

ConstanteValorDescripción
QCborKnownTags::DateTimeString0QDateTime
QCborKnownTags::UnixTime_t1QDateTime (solo en la decodificación)
QCborKnownTags::Url32QUrl
QCborKnownTags::Uuid37QUuid

Además, si un QCborValue que contenga un QByteArray está etiquetado con una de las siguientes etiquetas: ExpectedBase64url, ExpectedBase64 o ExpectedBase16, QCborValue utilizará la codificación esperada al convertirlo a JSON (véase QCborValue::toJsonValue).

Véase también QCborTag, QCborStreamWriter::append(QCborTag), QCborStreamReader::isTag(), QCborStreamReader::toTag(), QCborValue::isTag() y QCborValue::tag().

enum class QCborSimpleType

Esta enumeración contiene los posibles «tipos simples» de CBOR. Los tipos simples van del 0 al 255 y son tipos que no conllevan ningún valor adicional.

Actualmente se conocen los siguientes valores:

ConstanteValorDescripción
QCborSimpleType::False20Un valor booleano «falso».
QCborSimpleType::True21Un valor booleano «verdadero».
QCborSimpleType::Null22Ausencia de valor (nulo).
QCborSimpleType::Undefined23Valor ausente o eliminado, lo que suele indicar un error.

La API CBOR de Qt admite la codificación y decodificación de cualquier tipo simple, ya sea uno de los anteriores o cualquier otro valor.

Las aplicaciones solo deben utilizar otros valores si se ha publicado la especificación correspondiente; de lo contrario, la interpretación y la validación por parte del sistema remoto podrían fallar. Los valores del 24 al 31 están reservados y no deben utilizarse.

La lista oficial actual la mantiene la IANA en el registro de valores simples.

Véase también QCborStreamWriter::append(QCborSimpleType), QCborStreamReader::isSimpleType(), QCborStreamReader::toSimpleType(), QCborValue::isSimpleType() y QCborValue::toSimpleType().

enum class QCborTag

Esta enumeración no contiene ninguna enumeración y se utiliza únicamente para proporcionar un acceso seguro en cuanto al tipo a una etiqueta CBOR.

Las etiquetas CBOR son números de 64 bits que se asocian a tipos CBOR genéricos para aportar un significado semántico adicional. QCborTag puede crearse a partir de una enumeración que se encuentra en QCborKnownTags o directamente proporcionando la representación numérica.

Por ejemplo, el siguiente código crea un ` QCborValue ` que contiene una matriz de bytes etiquetada con la etiqueta 2.

QCborValue(QCborTag(2), QByteArray("\x01\0\0\0\0\0\0\0\0", 9));

Véase también QCborKnownTags, QCborStreamWriter::append(QCborTag), QCborStreamReader::isTag(), QCborStreamReader::toTag(), QCborValue::isTag() y QCborValue::tag().

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