<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 { } |
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.
| Constante | Valor | Descripción |
|---|---|---|
QCborKnownTags::DateTimeString | 0 | Una 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_t | 1 | Una representación numérica de los segundos transcurridos desde el 1 de enero de 1970 a las 00:00Z. |
QCborKnownTags::PositiveBignum | 2 | Un 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::NegativeBignum | 3 | Un 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::Decimal | 4 | Una 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::Bigfloat | 5 | Similar a «Decimal», pero el exponente es una potencia de 2. |
QCborKnownTags::COSE_Encrypt0 | 16 | Un mapa « Encrypt0 » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR). |
QCborKnownTags::COSE_Mac0 | 17 | Una asignación « Mac0 » tal y como se especifica en la RFC 8152 (Firma y cifrado de objetos CBOR). |
QCborKnownTags::COSE_Sign1 | 18 | Un mapa « Sign1 » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR). |
QCborKnownTags::ExpectedBase64url | 21 | Indica que la matriz de bytes debe codificarse utilizando Base64url si el flujo se convierte a JSON. |
QCborKnownTags::ExpectedBase64 | 22 | Indica que la matriz de bytes debe codificarse utilizando Base64 si el flujo se convierte a JSON. |
QCborKnownTags::ExpectedBase16 | 23 | Indica que la matriz de bytes debe codificarse utilizando Base16 (hexadecimal) si el flujo se convierte a JSON. |
QCborKnownTags::EncodedCbor | 24 | Indica que la matriz de bytes contiene un flujo CBOR. |
QCborKnownTags::Url | 32 | Indica que la cadena contiene una URL. |
QCborKnownTags::Base64url | 33 | Indica que la cadena contiene datos codificados mediante Base64url. |
QCborKnownTags::Base64 | 34 | Indica que la cadena contiene datos codificados mediante Base64. |
QCborKnownTags::RegularExpression | 35 | Indica que la cadena contiene un patrón de expresión regular compatible con Perl. |
QCborKnownTags::MimeMessage | 36 | Indica que la cadena contiene un mensaje MIME (según RFC 2045). |
QCborKnownTags::Uuid | 37 | Indica que la matriz de bytes contiene un UUID. |
QCborKnownTags::COSE_Encrypt | 96 | Un mapa « Encrypt » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR). |
QCborKnownTags::COSE_Mac | 97 | Un mapa « Mac » tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR). |
QCborKnownTags::COSE_Sign | 98 | Un mapa « Sign », tal y como se especifica en el RFC 8152 (Firma y cifrado de objetos CBOR). |
QCborKnownTags::Signature | 55799 | No 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.
| Constante | Valor | Descripción |
|---|---|---|
QCborKnownTags::DateTimeString | 0 | QDateTime |
QCborKnownTags::UnixTime_t | 1 | QDateTime (solo en la decodificación) |
QCborKnownTags::Url | 32 | QUrl |
QCborKnownTags::Uuid | 37 | QUuid |
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:
| Constante | Valor | Descripción |
|---|---|---|
QCborSimpleType::False | 20 | Un valor booleano «falso». |
QCborSimpleType::True | 21 | Un valor booleano «verdadero». |
QCborSimpleType::Null | 22 | Ausencia de valor (nulo). |
QCborSimpleType::Undefined | 23 | Valor 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.