En esta página

QCborValue Class

La clase QCborValue encapsula un valor en formato CBOR. Más información...

Encabezado: #include <QCborValue>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QCborValue

CategoríaTipos comparables
strongQCborValue

Tipos públicos

enum DiagnosticNotationOption { Compact, LineWrapped, ExtendedFormat }
flags DiagnosticNotationOptions
enum EncodingOption { NoTransformation, UseFloat, UseFloat16, UseIntegers }
flags EncodingOptions
enum Type { Integer, ByteArray, String, Array, Map, …, Uuid }

Funciones públicas

QCborValue()
QCborValue(QCborArray &&a)
QCborValue(QCborMap &&m)
QCborValue(QCborSimpleType st)
QCborValue(QCborValue::Type t_)
QCborValue(QStringView s)
QCborValue(bool b)
QCborValue(const QByteArray &ba)
QCborValue(const QCborArray &a)
QCborValue(const QCborMap &m)
QCborValue(const QDateTime &dt)
QCborValue(const QRegularExpression &rx)
QCborValue(const QString &s)
QCborValue(const QUrl &url)
QCborValue(const QUuid &uuid)
QCborValue(const void *)
QCborValue(double d)
QCborValue(qint64 i)
QCborValue(std::nullptr_t)
QCborValue(QCborKnownTags tag, const QCborValue &tv = QCborValue())
QCborValue(QCborTag tag, const QCborValue &tv = QCborValue())
QCborValue(QLatin1StringView s)
QCborValue(const QCborValue &other)
QCborValue(QCborValue &&other)
~QCborValue()
int compare(const QCborValue &other) const
bool isArray() const
bool isBool() const
bool isByteArray() const
bool isContainer() const
bool isDateTime() const
bool isDouble() const
bool isFalse() const
bool isInteger() const
bool isInvalid() const
bool isMap() const
bool isNull() const
bool isRegularExpression() const
bool isSimpleType() const
bool isSimpleType(QCborSimpleType st) const
bool isString() const
bool isTag() const
bool isTrue() const
bool isUndefined() const
bool isUrl() const
bool isUuid() const
void swap(QCborValue &other)
QCborTag tag(QCborTag defaultValue = QCborTag(-1)) const
QCborValue taggedValue(const QCborValue &defaultValue = QCborValue()) const
QCborArray toArray() const
QCborArray toArray(const QCborArray &defaultValue) const
bool toBool(bool defaultValue = false) const
QByteArray toByteArray(const QByteArray &defaultValue = {}) const
QByteArray toCbor(QCborValue::EncodingOptions opt = NoTransformation) const
void toCbor(QCborStreamWriter &writer, QCborValue::EncodingOptions opt = NoTransformation) const
QDateTime toDateTime(const QDateTime &defaultValue = {}) const
QString toDiagnosticNotation(QCborValue::DiagnosticNotationOptions opts = Compact) const
double toDouble(double defaultValue = 0) const
qint64 toInteger(qint64 defaultValue = 0) const
QJsonValue toJsonValue() const
QCborMap toMap() const
QCborMap toMap(const QCborMap &defaultValue) const
QRegularExpression toRegularExpression(const QRegularExpression &defaultValue = {}) const
QCborSimpleType toSimpleType(QCborSimpleType defaultValue = QCborSimpleType::Undefined) const
QString toString(const QString &defaultValue = {}) const
(since 6.10) QAnyStringView toStringView(QAnyStringView defaultValue = {}) const
QUrl toUrl(const QUrl &defaultValue = {}) const
QUuid toUuid(const QUuid &defaultValue = {}) const
QVariant toVariant() const
QCborValue::Type type() const
QCborValue &operator=(const QCborValue &other)
QCborValue &operator=(QCborValue &&other)
QCborValueRef operator[](const QString &key)
const QCborValue operator[](const QString &key) const
QCborValueRef operator[](QLatin1StringView key)
QCborValueRef operator[](qint64 key)
const QCborValue operator[](QLatin1StringView key) const
const QCborValue operator[](qint64 key) const

Miembros públicos estáticos

QCborValue fromCbor(QCborStreamReader &reader)
QCborValue fromCbor(const QByteArray &ba, QCborParserError *error = nullptr)
QCborValue fromCbor(const char *data, qsizetype len, QCborParserError *error = nullptr)
QCborValue fromCbor(const quint8 *data, qsizetype len, QCborParserError *error = nullptr)
QCborValue fromJsonValue(const QJsonValue &v)
QCborValue fromVariant(const QVariant &variant)
bool operator!=(const QCborValue &lhs, const QCborValue &rhs)
bool operator<(const QCborValue &lhs, const QCborValue &rhs)
bool operator<=(const QCborValue &lhs, const QCborValue &rhs)
bool operator==(const QCborValue &lhs, const QCborValue &rhs)
bool operator>(const QCborValue &lhs, const QCborValue &rhs)
bool operator>=(const QCborValue &lhs, const QCborValue &rhs)

Descripción detallada

Esta clase se puede utilizar para almacenar uno de los muchos tipos disponibles en CBOR. CBOR son las siglas de «Concise Binary Object Representation» (Representación concisa de objetos binarios), un formato muy compacto de codificación de datos binarios que constituye un superconjunto de JSON. Fue creado por el grupo de trabajo «Constrained RESTful Environments» (CoRE) de la IETF, que lo ha utilizado en muchos nuevos RFC. Está pensado para utilizarse junto con el protocolo CoAP.

CBOR cuenta con tres grupos de tipos integrados:

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

Además, CBOR admite una forma de extensibilidad de tipos mediante la asociación de una «etiqueta» a uno de los tipos anteriores para transmitir más información. Por ejemplo, un UUID se representa mediante una etiqueta y una matriz de bytes que contiene los 16 bytes del contenido del UUID. QCborValue permite crear y descodificar varios de esos tipos extendidos directamente con clases de Qt (como QUuid).

Para ver la lista completa, consulta QCborValue::Type. El tipo de un QCborValue se puede consultar mediante type() o una de las funciones «isXxxx».

Tipos extendidos y valores etiquetados

Un valor etiquetado es un QCborValue normal que va acompañado de un número que constituye su etiqueta. Consulte QCborKnownTags para obtener más información sobre las etiquetas disponibles en la API, así como la lista oficial completa. Dichas combinaciones forman los tipos extendidos.

QCborValue admite ciertos tipos extendidos en la API, como URL (con QUrl) y UUID (con QUuid). Otros tipos extendidos no admitidos en la API se representan mediante un QCborValue de tipo Tag. La etiqueta se puede recuperar posteriormente mediante tag() y el valor etiquetado mediante taggedValue().

Con el fin de garantizar la compatibilidad futura, los objetos `QCborValue` que contienen tipos Qt extendidos se consideran iguales al tipo de etiqueta con el mismo contenido. En otras palabras, la siguiente expresión es verdadera:

QCborValue(uuid) == QCborValue(QCborKnownTags::Uuid, uuid.toRfc4122());

Valores indefinidos y nulos

QCborValue puede contener un valor «nulo», que no es de ningún tipo específico. Se asemeja al tipo « std::nullptr_t » de C++, cuyo único valor posible es « nullptr ». QCborValue dispone de un constructor que toma dicho tipo y crea un QCborValue nulo.

Los valores nulos se utilizan para indicar que un valor opcional no está presente. En ese aspecto, es similar al tipo « std::optional » de la biblioteca estándar de C++ cuando está desactivado. A diferencia del tipo de C++, los valores nulos de CBOR son simplemente de tipo «Null» y no es posible determinar qué tipo concreto están sustituyendo.

QCborValue también puede ser de tipo «undefined», que representa un valor «indefinido». De hecho, eso es lo que crea el constructor por defecto de QCborValue.

Los valores «Undefined» son distintos de los valores nulos. Mientras que los valores nulos se utilizan para indicar un valor opcional que no se ha proporcionado, «Undefined» se utiliza normalmente para indicar que no se ha podido proporcionar un valor esperado, por lo general debido a un error o a una precondición que no se ha podido cumplir.

Dichos valores son totalmente válidos y pueden aparecer en flujos CBOR, a diferencia del contenido JSON y del bit «undefined» de QJsonValue. Pero, al igual que el valor «Undefined» de QJsonValue, es devuelto por el método value() o el operador [] de solo lectura de un contenedor CBOR en caso de búsquedas inválidas (índice fuera de rango para QCborArray, o clave no encontrada para QCborMap). No es posible distinguir este caso del valor de «Undefined», por lo que, si es necesario, comprueba el tamaño en QCborArray y utiliza la API del iterador QCborMap.

Tipos simples

CBOR admite tipos simples adicionales que, al igual que «Null» y «Undefined», no tienen ningún otro valor. Se denominan indistintamente «tipos simples» y «valores simples». CBOR codifica los valores booleanos como dos tipos distintos (uno para true y otro para false), pero QCborValue dispone de una API de conveniencia para ellos.

Actualmente no hay otros tipos simples de CBOR definidos. QCborValue los admite simplemente por su número mediante una API como isSimpleType() y toSimpleType(), disponible para garantizar la compatibilidad con futuras especificaciones antes de que se pueda actualizar la API de Qt. Se desaconseja su uso antes de que exista dicha especificación, ya que es posible que otras implementaciones de CBOR no los admitan por completo.

Compatibilidad con CBOR

QCborValue admite todas las características de CBOR necesarias para crear flujos canónicos y estrictos. Implementa casi todas las características especificadas en el RFC 7049.

La siguiente tabla enumera las características de CBOR que admite QCborValue.

CaracterísticaCompatibilidad
Números sin signoSí (rango deqint64 )
Números negativosSí (rangoqint64 )
Cadenas de bytesSí
Cadenas de textoSí
Cadenas fragmentadasVéase más abajo
EtiquetasSí (arbitrarias)
Valores booleanosSí
NuloSí
IndeterminadoSí
Valores simples arbitrariosSí
Número flotante de media precisión (16 bits)Sí
Número flotante de precisión simple (32 bits)Sí
Número real de doble precisión (64 bits)Sí
Valores infinitos y NaN en coma flotanteSí
Matrices y mapas de longitud determinadaSí
Matrices y mapas de longitud indeterminadaSí
Tipos de claves de mapas distintos de cadenas e enterosSí (arbitrario)

Los enteros en QCborValue están limitados al rango del tipo « qint64 ». Es decir, desde -9 223 372 036 854 775 808 (-263) hasta 9 223 372 036 854 775 807 (263 - 1). El propio CBOR puede representar valores enteros fuera de este rango, algo que QCborValue no admite. Al decodificar un flujo mediante ` fromCbor()` que contenga uno de esos valores, QCborValue lo convertirá automáticamente en ` Double`, pero eso puede suponer una pérdida de hasta 11 bits de precisión.

fromCbor() es capaz de decodificar cadenas fragmentadas, pero siempre fusionará los fragmentos en un único QCborValue. Por ese motivo, siempre escribe cadenas no fragmentadas cuando se utiliza toCbor() (lo cual, de todos modos, es un requisito del formato Canonical).

QCborValue siempre convertirá los valores de coma flotante de media y simple precisión del flujo CBOR a doble precisión. La función toCbor() puede aceptar un parámetro que indique que se deben recrear.

QCborValueRef

QCborValueRef es una clase auxiliar para QCborArray y QCborMap. Es el tipo que se obtiene al utilizar una de las API mutantes de esas clases. A diferencia de QCborValue, a esta clase se le pueden asignar nuevos valores. Cuando esto ocurre, la matriz o el mapa al que hace referencia se modificará con el nuevo valor. En todos los demás aspectos, su API es idéntica a la de QCborValue.

Véase también QCborArray, QCborMap, QCborStreamReader, QCborStreamWriter, QJsonValue, QJsonDocument, «Convertidor de serialización» y «Análisis y visualización de datos CBOR».

Documentación sobre los tipos de miembro

enum QCborValue::DiagnosticNotationOption
flags QCborValue::DiagnosticNotationOptions

Esta enumeración se utiliza en el argumento «option» de la función toDiagnosticNotation(), para modificar el formato de salida.

ConstanteValorDescripción
QCborValue::Compact0x00No utiliza ningún salto de línea, lo que da lugar a una representación compacta.
QCborValue::LineWrapped0x01Utiliza saltos de línea, con un QCborValue por línea.
QCborValue::ExtendedFormat0x02Utiliza algunas opciones diferentes para representar los valores, que no aparecen en el RFC 7049. Dichas opciones están sujetas a cambios.

Actualmente, « ExtendedFormat » modifica la forma en que se representan las matrices de bytes. Sin esta opción, siempre se codifican en hexadecimal y sin espacios. Con ella, « QCborValue::toCbor()» utilizará codificación hexadecimal con espacios, base64 o base64url, dependiendo del contexto.

El tipo `DiagnosticNotationOptions` es un `typedef` para ` QFlags<DiagnosticNotationOption>`. Almacena una combinación OR de valores de `DiagnosticNotationOption`.

Véase también ` toDiagnosticNotation()`.

enum QCborValue::EncodingOption
flags QCborValue::EncodingOptions

Esta enumeración se utiliza en el argumento «options» de la función toCbor(), para modificar el comportamiento del codificador.

ConstanteValorDescripción
QCborValue::NoTransformation0(Predeterminado) No realiza ninguna transformación.
QCborValue::UseFloat0x02Indica al codificador que utilice la coma flotante de precisión simple IEEE 754 (es decir, float) siempre que sea posible.
QCborValue::UseFloat16UseFloat | 0x04Indica al codificador que utilice la coma flotante de media precisión IEEE 754 (es decir, qfloat16) siempre que sea posible. Implica UseFloat.
QCborValue::UseIntegers0x08Indica al codificador que utilice números enteros siempre que un valor de tipo Double contenga un número entero.

El uso de « UseFloat16 » es obligatorio para codificar el flujo en formato canónico, pero no es necesario en ningún otro caso.

El tipo `EncodingOptions` es una definición de tipo (`typedef`) para ` QFlags<EncodingOption>`. Almacena una combinación OR de valores de `EncodingOption`.

Véase también toCbor().

enum QCborValue::Type

Esta enumeración representa el tipo « QCborValue ». Es el valor que devuelve la función « type()».

Los tipos integrados de CBOR son:

ConstanteValorDescripción
QCborValue::Integer0x00qint64: Un valor entero
QCborValue::ByteArray0x40QByteArray: una matriz de bytes («cadena de bytes»)
QCborValue::String0x60QString: una cadena Unicode («cadena de texto»)
QCborValue::Array0x80QCborArray: una matriz de QCborValues
QCborValue::Map0xa0QCborMap: un contenedor asociativo de QCborValues
QCborValue::SimpleType0x100QCborSimpleType: uno de varios tipos o valores simples
QCborValue::FalseSimpleType + int(QCborSimpleType::False)bool: el tipo simple para el valor false
QCborValue::TrueSimpleType + int(QCborSimpleType::True)bool: el tipo simple para el valor true
QCborValue::NullSimpleType + int(QCborSimpleType::Null)std::nullptr_t: el tipo simple del valor nulo
QCborValue::UndefinedSimpleType + int(QCborSimpleType::Undefined)(sin tipo) el tipo simple para el valor indefinido
QCborValue::Double0x202double: un número de coma flotante de doble precisión
QCborValue::Invalid-1Valor no válido; suele indicar un error de decodificación CBOR

Además, QCborValue puede representar tipos extendidos:

ConstanteValorDescripción
QCborValue::Tag0xc0Un tipo ampliado desconocido o no reconocido, representado por su etiqueta (un QCborTag) y el valor etiquetado (un QCborValue)
QCborValue::DateTime0x10000QDateTime: una marca de fecha y hora
QCborValue::Url0x10020QUrl: una URL o un URI
QCborValue::RegularExpression0x10023QRegularExpression: el patrón de una expresión regular
QCborValue::Uuid0x10025QUuid: un UUID

Véase también type().

Documentación de funciones miembro

QCborValue::QCborValue()

Crea un objeto `QCborValue` del tipo ` Undefined `.

Los valores no definidos de CBOR se utilizan para indicar que falta información, normalmente como resultado de una operación anterior que no se completó según lo esperado. También son utilizados por las API QCborArray y QCborMap para indicar que no se ha encontrado el elemento buscado.

Los valores indefinidos se representan mediante el tipo « Undefined simple type ». Por ello, los objetos «QCborValue» con valores indefinidos también devolverán «true» para las funciones « isSimpleType()» y « isSimpleType(QCborSimpleType::Undefined) ».

Los valores no definidos son distintos de los valores nulos.

Los objetos `QCborValue` con valores indefinidos también son distintos de los objetos `QCborValue` no válidos. La API no creará objetos `QCborValue` no válidos, pero estos pueden existir como resultado de un error de análisis.

Véase también isUndefined(), isNull() y isSimpleType().

QCborValue::QCborValue(QCborArray &&a)

QCborValue::QCborValue(const QCborArray &a)

Crea un objeto ` QCborValue ` con el array ` a`. El array se puede recuperar posteriormente mediante la función ` toArray()`.

Véanse también toArray(), isArray() y isMap().

QCborValue::QCborValue(QCborMap &&m)

QCborValue::QCborValue(const QCborMap &m)

Crea un objeto ` QCborValue ` con el mapa ` m`. El mapa se puede recuperar posteriormente mediante ` toMap()`.

Véase también toMap(), isMap() y isArray().

QCborValue::QCborValue(QCborSimpleType st)

Crea un objeto `QCborValue` de tipo simple ` st`. Posteriormente, el tipo se puede recuperar mediante ` toSimpleType()` y ` isSimpleType(st)`.

Los tipos simples CBOR son tipos que no tienen ningún valor asociado, como el tipo ` std::nullptr_t ` de C++, cuyo único valor posible es ` nullptr`.

Si st es QCborSimpleType::Null, el QCborValue resultante será de tipo Null y lo mismo ocurrirá con QCborSimpleType::Undefined. Si st es QCborSimpleType::False o QCborSimpleType::True, el QCborValue creado será un valor booleano que contenga el valor false o true, respectivamente.

Esta función se puede utilizar con tipos simples no definidos en la API. Por ejemplo, para crear un QCborValue con el tipo simple 12, se podría escribir:

Los tipos simples no deben utilizarse hasta que se haya publicado una especificación para ellos, ya que es posible que otras implementaciones no los admitan correctamente. Los valores de tipo simple del 24 al 31 están reservados y no deben utilizarse.

isSimpleType(), isNull(), isUndefined(), isTrue(), isFalse()

QCborValue::QCborValue(QCborValue::Type t_)

Crea un objeto `QCborValue` de tipo ` t_`. El valor asociado a dicho tipo (si lo hay) se inicializará de forma predeterminada.

Véase también ` type()`.

QCborValue::QCborValue(QStringView s)

Crea un objeto QCborValue con el valor de cadena « s ». El valor se puede recuperar posteriormente mediante la función « toString()».

Véanse también toString(), isString() y isByteArray().

QCborValue::QCborValue(bool b)

Crea un objeto `QCborValue` con el valor booleano ` b`. El valor se puede recuperar posteriormente mediante la función ` toBool()`.

Internamente, los valores booleanos CBOR se representan mediante un par de tipos, uno para «true» y otro para «false». Por ese motivo, los objetos QCborValue de tipo booleano devolverán «true» al llamar a isSimpleType() y uno de los siguientes valores: isSimpleType(QCborSimpleType::False) o isSimpleType(QCborSimpleType::True).

Véanse también toBool(), isBool(), isTrue(), isFalse() y isSimpleType().

QCborValue::QCborValue(const QByteArray &ba)

Crea un objeto QCborValue con un valor de matriz de bytes ba. El valor se puede recuperar posteriormente mediante la función toByteArray().

Véanse también toByteArray(), isByteArray() y isString().

[explicit] QCborValue::QCborValue(const QDateTime &dt)

Crea un objeto QCborValue del tipo extendido de fecha y hora que contiene el valor representado por dt. El valor se puede recuperar posteriormente mediante toDateTime().

Los tipos de fecha y hora de CBOR son tipos de extensión que utilizan etiquetas: bien una cadena (en formato de fecha ISO) etiquetada como « DateTime », bien un número (de segundos desde el inicio de 1970, UTC) etiquetado como « UnixTime_t ». Al analizar flujos CBOR, QCborValue convertirá « UnixTime_t » al tipo basado en cadenas.

Véase también toDateTime(), isDateTime() y taggedValue().

[explicit] QCborValue::QCborValue(const QRegularExpression &rx)

Crea un objeto `QCborValue` del tipo ampliado «patrón de expresión regular» que contiene el valor representado por ` rx`. El valor se puede recuperar posteriormente mediante ` toRegularExpression()`.

El tipo de expresión regular CBOR es un tipo ampliado representado por una cadena etiquetada como RegularExpression. Tenga en cuenta que las expresiones regulares CBOR solo almacenan los patrones, por lo que se perderán los indicadores que pueda contener el objeto QRegularExpression.

Véanse también toRegularExpression(), isRegularExpression() y taggedValue().

QCborValue::QCborValue(const QString &s)

Crea un objeto QCborValue con el valor de cadena « s ». El valor se puede recuperar posteriormente mediante la función « toString()».

Véase también toString(), isString() y isByteArray().

[explicit] QCborValue::QCborValue(const QUrl &url)

Crea un objeto QCborValue del tipo URL ampliado que contiene el valor representado por url. El valor se puede recuperar posteriormente mediante toUrl().

El tipo URL CBOR es un tipo ampliado representado por una cadena etiquetada como Url.

Véase también toUrl(), isUrl() y taggedValue().

[explicit] QCborValue::QCborValue(const QUuid &uuid)

Crea un objeto QCborValue del tipo extendido UUID que contiene el valor representado por uuid. El valor se puede recuperar posteriormente mediante toUuid().

El tipo UUID de CBOR es un tipo extendido representado por una matriz de bytes etiquetada como « Uuid ».

Véase también toUuid(), isUuid() y taggedValue().

[delete] QCborValue::QCborValue(const void *)

Crea por defecto una instancia de ` QCborValue`. Esta función se ha eliminado.

QCborValue::QCborValue(double d)

Crea un objeto `QCborValue` con el valor de coma flotante ` d`. Posteriormente, el valor se puede recuperar mediante la función ` toDouble()`.

Los valores de coma flotante CBOR son distintos de los valores enteros. Por lo tanto, los objetos QCborValue con valores enteros se compararán de forma diferente a los objetos QCborValue que contengan valores de coma flotante, incluso si los valores contenidos en los objetos son equivalentes.

Véanse también toDouble(), isDouble() y isInteger().

QCborValue::QCborValue(qint64 i)

Crea un objeto `QCborValue` con el valor entero ` i`. El valor se puede recuperar posteriormente mediante ` toInteger()`.

Los valores enteros CBOR son distintos de los valores de coma flotante. Por lo tanto, los objetos `QCborValue` con valores enteros se compararán de forma diferente a los objetos `QCborValue` que contengan valores de coma flotante, incluso si los valores contenidos en los objetos son equivalentes.

Véanse también toInteger(), isInteger() y isDouble().

QCborValue::QCborValue(std::nullptr_t)

Crea un objeto `QCborValue` del tipo ` Null `.

Los valores nulos de CBOR se utilizan para indicar valores opcionales que no se han proporcionado. Se diferencian de los valores indefinidos en que los valores nulos no suelen ser el resultado de un error o problema anterior.

Véase también isNull(), isUndefined() y isSimpleType().

QCborValue::QCborValue(QCborKnownTags tag, const QCborValue &tv = QCborValue())

QCborValue::QCborValue(QCborTag tag, const QCborValue &tv = QCborValue())

Crea un objeto « QCborValue » para el tipo ampliado representado por el valor de la etiqueta tag y el valor etiquetado tv. Posteriormente, la etiqueta se puede recuperar mediante tag() y el valor etiquetado mediante taggedValue().

Véase también isTag(), tag(), taggedValue() y QCborKnownTags.

QCborValue::QCborValue(QLatin1StringView s)

Crea un objeto `QCborValue` con la cadena en formato Latin-1 tal y como la interpreta s. El valor se puede recuperar posteriormente mediante toString().

Esta es una función sobrecargada.

Véanse también toString(), isString() y isByteArray().

[noexcept] QCborValue::QCborValue(const QCborValue &other)

Copia el contenido de « other » en este objeto.

[noexcept] QCborValue::QCborValue(QCborValue &&other)

Traslada el contenido del objeto QCborValue de « other » a este y libera los recursos de este último.

Esta es una función sobrecargada.

[noexcept] QCborValue::~QCborValue()

Elimina el objeto ` QCborValue ` actual y libera los recursos asociados.

int QCborValue::compare(const QCborValue &other) const

Compara este valor con other y devuelve un entero que indica si este valor debe ordenarse antes (si el resultado es negativo) o después de other (si el resultado es positivo). Si esta función devuelve 0, los dos valores son iguales y tienen el mismo contenido.

Si cada QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Tipos extendidos

QCborValue considera iguales a un ` QCborValue ` que contenga un tipo extendido, como ` Url ` y ` Url `, y su representación etiquetada equivalente. Así, por ejemplo, la siguiente expresión es verdadera:

QCborValue(QUrl("https://example.com")) == QCborValue(QCborKnownTags::Url, "https://example.com");

Ten en cuenta que los tipos de Qt, como QUrl y QDateTime, normalizarán y modificarán de otro modo sus argumentos. La expresión anterior es verdadera únicamente porque la cadena del lado derecho es el valor normalizado que adoptaría el QCborValue del lado izquierdo. Si, por ejemplo, la parte «https» estuviera en mayúsculas en ambos lados, la comparación fallaría. Para obtener información sobre las normalizaciones realizadas por QCborValue, consulta la documentación del constructor que admite el tipo Qt en cuestión.

Orden de clasificación

El orden de clasificación en CBOR se define en la RFC 7049, sección 3.9, que trata sobre la clasificación de claves en un mapa cuando se sigue la codificación canónica. Según la especificación, «la clasificación se realiza sobre los bytes de la representación de los elementos de datos de la clave» y enumera como consecuencias que:

  • «Si dos claves tienen longitudes diferentes, la más corta se ordena antes;»
  • «Si dos claves tienen la misma longitud, la que tenga el valor más bajo en orden léxico (por bytes) se ordena antes».

Esto da lugar a una ordenación sorprendente de los QCborValues, en la que el resultado de esta función difiere del que se obtendría posteriormente al comparar los elementos contenidos. Por ejemplo, el QCborValue que contiene la cadena «zzz» se ordena antes que el QCborValue con la cadena «foobar», aunque al compararlos como QStrings o QByteArrays, «zzz» se ordena después de «foobar» (orden diccionario).

La especificación no indica claramente qué orden de clasificación debe aplicarse a los valores de diferentes tipos (señala que la clasificación no debe «tener en cuenta la división de 3/5 bits para los tipos principales»). QCborValue parte de la base de que los tipos también deben clasificarse. Los valores numéricos de la enumeración QCborValue::Type siguen ese orden, con la excepción de los tipos extendidos, que se comparan como sus equivalentes etiquetados.

Nota: El ordende ordenación es preliminar y está sujeto a cambios. Por el momento, las aplicaciones no deben basarse en el orden devuelto por esta función.

Véanse también QCborArray::compare(), QCborMap::compare() y operator==().

[static] QCborValue QCborValue::fromCbor(QCborStreamReader &reader)

Decodifica un elemento del flujo CBOR que se encuentra en reader y devuelve la representación equivalente. Esta función es recursiva: si el elemento es un mapa o una matriz, decodificará todos los elementos que se encuentren en dicho mapa o matriz, hasta que se haya completado el objeto más externo.

No es necesario utilizar esta función en el elemento raíz de un QCborStreamReader. Por ejemplo, el siguiente código ilustra cómo omitir la etiqueta de firma CBOR del principio de un archivo:

if (reader.isTag() && reader.toTag() == QCborKnownTags::Signature)
    reader.next();

QCborValue contents = QCborValue::fromCbor(reader);

El valor devuelto puede estar parcialmente completo y ser indistinguible de un QCborValue válido, incluso si la decodificación ha fallado. Para determinar si se ha producido un error, comprueba si reader.lastError() indica una condición de error. Esta función detiene la decodificación inmediatamente tras el primer error.

Véanse también toCbor(), toDiagnosticNotation(), toVariant() y toJsonValue().

[static] QCborValue QCborValue::fromCbor(const QByteArray &ba, QCborParserError *error = nullptr)

Decodifica un elemento del flujo CBOR que se encuentra en la matriz de bytes ` ba ` y devuelve la representación equivalente. Esta función es recursiva: si el elemento es un mapa o una matriz, decodificará todos los elementos que se encuentren en dicho mapa o matriz, hasta que se haya completado el objeto más externo.

Esta función almacena el estado de error, si lo hay, en el objeto al que apunta error, junto con el desplazamiento (offset) del lugar donde se produjo el error. Si no se ha producido ningún error, almacena NoError en el estado de error y el número de bytes que ha consumido (es decir, almacena el desplazamiento del primer byte no utilizado). El uso de esa información permite analizar los datos adicionales que puedan existir en la misma matriz de bytes.

El valor devuelto puede estar parcialmente completo y ser indistinguible de un ` QCborValue ` válido, incluso si la decodificación ha fallado. Para determinar si se ha producido un error, comprueba si hay un error almacenado en ` error`. Esta función detiene la decodificación inmediatamente después del primer error.

Esta es una función sobrecargada.

Véanse también toCbor(), toDiagnosticNotation(), toVariant() y toJsonValue().

[static] QCborValue QCborValue::fromCbor(const char *data, qsizetype len, QCborParserError *error = nullptr)

[static] QCborValue QCborValue::fromCbor(const quint8 *data, qsizetype len, QCborParserError *error = nullptr)

Convierte len bytes de data en un QByteArray y, a continuación, llama a la sobrecarga de esta función que admite un QByteArray, pasando también error, si se ha proporcionado.

[static] QCborValue QCborValue::fromJsonValue(const QJsonValue &v)

Convierte el valor JSON contenido en v en su valor CBOR correspondiente y lo devuelve. No se produce ninguna pérdida de datos al convertir de JSON a CBOR, ya que el conjunto de tipos de CBOR es más amplio que el de JSON. Además, los valores convertidos a CBOR mediante esta función pueden volver a convertirse a JSON utilizando toJsonValue() sin pérdida de datos.

La siguiente tabla muestra la correspondencia entre los tipos JSON y los tipos CBOR:

Tipo JSONTipo CBOR
BoolBool
NumberEntero (si el número no tiene fracción y está dentro del rango qint64 ) o Doble
CadenaCadena
MatrizMatriz
ObjetoMapa
NuloNulo

QJsonValue también puede estar sin definir, lo que indica que una operación anterior no se completó correctamente (por ejemplo, la búsqueda de una clave que no está presente en un objeto). Los valores sin definir no son tipos JSON y no pueden aparecer en matrices ni objetos JSON, pero esta función devuelve el valor sin definir QCborValue si la propiedad correspondiente QJsonValue está sin definir.

Véase también toJsonValue(), fromVariant(), QCborArray::fromJsonArray() y QCborMap::fromJsonObject().

[static] QCborValue QCborValue::fromVariant(const QVariant &variant)

Convierte el objeto ` QVariant ` ` variant ` en ` QCborValue ` y lo devuelve.

Los QVariants pueden contener una amplia lista de metatipos diferentes, muchos de los cuales no tienen una representación correspondiente en CBOR. Esto incluye todos los metatipos definidos por el usuario. Al preparar la transmisión mediante CBOR, se recomienda codificar cuidadosamente cada valor para evitar la pérdida de representación.

La siguiente tabla enumera las conversiones que aplicará esta función:

Tipo Qt (C++)Tipo CBOR
no válido (QVariant())Sin definir
boolBool
std::nullptr_tNulo
short, ushort, int, uint, qint64entero
quint64Integer, o Double si está fuera del rango de qint64
float, doubleDouble
QByteArrayByteArray
QDateTimeDateTime
QCborSimpleTypeTipo simple
QJsonArrayMatriz, convertida mediante QCborArray::formJsonArray()
QJsonDocumentMatriz o mapa
QJsonObjectMapa, convertido mediante ` QCborMap::fromJsonObject()`
QJsonValueconvertido mediante ` fromJsonValue()`
QRegularExpressionRegularExpression
QStringCadena
QStringListMatriz
QVariantHashMapa
QVariantListMatriz
QVariantMapMapa
QUrlURL
QUuidUUID

Si QVariant::isNull() devuelve «true», se devuelve un QCborValue nulo o se inserta en la lista u objeto, independientemente del tipo que contenga QVariant. Ten en cuenta que el cambio de comportamiento en Qt 6.0 que afecta a QVariant::isNull() también afecta a esta función.

Para otros tipos no enumerados anteriormente, se intentará una conversión a cadena, normalmente —aunque no siempre— llamando a QVariant::toString(). Si la conversión falla, el valor se sustituye por un valor CBOR indefinido. Ten en cuenta que QVariant::toString() también implica pérdida de información para la mayoría de los tipos.

Tenga en cuenta que las conversiones realizadas mediante QVariant::toString() están sujetas a cambios en cualquier momento. Tanto QVariant como QCborValue podrían ampliarse en el futuro para admitir más tipos, lo que daría lugar a un cambio en la forma en que esta función realiza las conversiones.

Véase también toVariant(), fromJsonValue(), QCborArray::toVariantList(), QCborMap::toVariantMap() y QJsonValue::fromVariant().

bool QCborValue::isArray() const

Devuelve «true» si este objeto ` QCborValue ` es de tipo matriz. El valor de la matriz se puede obtener mediante ` toArray()`.

Véase también type() y toArray().

bool QCborValue::isBool() const

Devuelve «true» si este « QCborValue » es un valor booleano. El valor se puede obtener mediante « toBool()».

Véase también type(), toBool(), isTrue() y isFalse().

bool QCborValue::isByteArray() const

Devuelve «true» si este objeto ` QCborValue ` es de tipo matriz de bytes. El valor de la matriz de bytes se puede obtener mediante la función ` toByteArray()`.

Véase también type() y toByteArray().

bool QCborValue::isContainer() const

Esta función de conveniencia devuelve «true» si ` QCborValue ` es una matriz o un mapa.

Véanse también « isArray()» y « isMap()».

bool QCborValue::isDateTime() const

Devuelve «true» si este objeto « QCborValue » es de tipo fecha/hora. El valor se puede obtener mediante « toDateTime()». Las fechas y horas son tipos extendidos que utilizan la etiqueta « DateTime ».

Además, al decodificar desde un flujo CBOR, QCborValue interpretará las etiquetas con el valor UnixTime_t y las convertirá en la fecha y hora equivalentes.

Véase también type() y toDateTime().

bool QCborValue::isDouble() const

Devuelve «true» si este objeto « QCborValue » es de tipo de coma flotante. El valor se puede obtener mediante la función « toDouble()».

Véase también type() y toDouble().

bool QCborValue::isFalse() const

Devuelve «true» si este QCborValue es un valor booleano con el valor «false». Esta función existe porque, internamente, los valores booleanos CBOR se almacenan como dos tipos distintos: uno para «true» y otro para «false».

Véanse también type(), isBool(), isTrue() y toBool().

bool QCborValue::isInteger() const

Devuelve «true» si este objeto « QCborValue » es de tipo entero. El valor entero se puede obtener mediante la función « toInteger()».

Véase también type() y toInteger().

bool QCborValue::isInvalid() const

Devuelve «true» si este objeto « QCborValue » no es de ningún tipo válido. Los valores «QCborValues» no válidos se diferencian de aquellos con valores indefinidos y suelen indicar un error de decodificación.

Véase también isUndefined() y isNull().

bool QCborValue::isMap() const

Devuelve «true» si este objeto ` QCborValue ` es de tipo «map». El valor del «map» se puede recuperar mediante ` toMap()`.

Véase también type() y toMap().

bool QCborValue::isNull() const

Devuelve «true» si este objeto « QCborValue » es de tipo nulo.

Los valores nulos de CBOR se utilizan para indicar valores opcionales que no se han proporcionado. Se diferencian de los valores indefinidos en que los valores nulos no suelen ser el resultado de un error o problema anterior.

Los valores nulos se diferencian de los valores indefinidos y de los objetos ` QCborValue ` no válidos. La API no creará objetos `QCborValues` no válidos, pero estos pueden existir como resultado de un error de análisis sintáctico.

Véase también type(), isUndefined() y isInvalid().

bool QCborValue::isRegularExpression() const

Devuelve «true» si este objeto ` QCborValue ` contiene un patrón de expresión regular. El patrón se puede obtener mediante la función ` toRegularExpression()`.

Véase también type() y toRegularExpression().

bool QCborValue::isSimpleType() const

Devuelve «true» si este objeto ` QCborValue ` es de uno de los tipos simples CBOR. El tipo en sí mismo se puede recuperar posteriormente mediante ` type()`, incluso en el caso de tipos que no cuenten con una enumeración en la API. También se pueden comprobar mediante la sobrecarga de ` isSimpleType` (`QCborSimpleType`).

Véase también QCborSimpleType, isSimpleType(QCborSimpleType) y toSimpleType().

bool QCborValue::isSimpleType(QCborSimpleType st) const

Devuelve «true» si este objeto ` QCborValue ` es de un tipo simple y ` toSimpleType()` devolvería ` st`; en caso contrario, devuelve «false». Esta función se puede utilizar para comprobar cualquier tipo simple de CBOR, incluso aquellos para los que no existe una enumeración en la API. Por ejemplo, para el tipo simple con valor 12, se podría escribir:

value.isSimpleType(QCborSimpleType(12));

Esta es una función sobrecargada.

Véase también QCborValue::QCborValue(QCborSimpleType), isSimpleType(), isFalse(), isTrue(), isNull, isUndefined() y toSimpleType().

bool QCborValue::isString() const

Devuelve «true» si este objeto ` QCborValue ` es de tipo cadena. El valor de la cadena se puede obtener mediante ` toString()`.

Véase también type() y toString().

bool QCborValue::isTag() const

Devuelve «true» si este objeto ` QCborValue ` es del tipo «tag». El valor de la etiqueta se puede recuperar mediante ` tag()` y el valor etiquetado mediante ` taggedValue()`.

Esta función también devuelve «true» para los tipos extendidos que reconoce la API. En el caso del código que maneja tipos extendidos directamente antes de que la API de Qt se actualice para admitirlos, es posible recrear el par «etiqueta + valor etiquetado» utilizando ` taggedValue()`.

Véase también type(), tag() y taggedValue().

bool QCborValue::isTrue() const

Devuelve «true» si este « QCborValue » es un valor booleano con el valor «true». Esta función existe porque, internamente, los valores booleanos de CBOR se almacenan como dos tipos distintos: uno para «false» y otro para «true».

Véase también type(), isBool(), isFalse() y toBool().

bool QCborValue::isUndefined() const

Devuelve «true» si este objeto « QCborValue » es de tipo «undefined».

Los valores «undefined» de CBOR se utilizan para indicar que falta información, normalmente como resultado de una operación anterior que no se completó según lo esperado. También son utilizados por las API QCborArray y QCborMap para indicar que no se ha encontrado el elemento buscado.

Los valores indefinidos son distintos de los valores nulos.

QCborValue Los objetos con valores indefinidos también son distintos de los objetos QCborValue no válidos. La API no creará valores QCborValues no válidos, pero estos pueden existir como resultado de un error de análisis sintáctico.

Véase también type(), isNull() y isInvalid().

bool QCborValue::isUrl() const

Devuelve «true» si este objeto « QCborValue » es de tipo URL. El valor de la URL se puede obtener mediante la función « toUrl()».

Véase también type() y toUrl().

bool QCborValue::isUuid() const

Devuelve «true» si este objeto ` QCborValue ` contiene un UUID. El valor se puede obtener mediante la función ` toUuid()`.

Véase también type() y toUuid().

[noexcept] void QCborValue::swap(QCborValue &other)

Intercambia este valor con other. Esta operación es muy rápida y nunca falla.

QCborTag QCborValue::tag(QCborTag defaultValue = QCborTag(-1)) const

Devuelve la etiqueta de este objeto « QCborValue » ampliado, si es de tipo «tag»; en caso contrario, devuelve « defaultValue ».

CBOR representa los tipos extendidos asociando un número (la etiqueta) a una representación almacenada. Esta función devuelve ese número. Para recuperar la representación, utilice taggedValue().

Véase también isTag(), taggedValue(), isDateTime(), isUrl(), isRegularExpression() y isUuid().

QCborValue QCborValue::taggedValue(const QCborValue &defaultValue = QCborValue()) const

Devuelve el valor etiquetado de este objeto « QCborValue » ampliado, si es del tipo «tag»; en caso contrario, devuelve « defaultValue ».

CBOR representa los tipos ampliados asociando un número (la etiqueta) a una representación almacenada. Esta función devuelve dicha representación. Para recuperar la etiqueta, utilice tag().

Véase también isTag(), tag(), isDateTime(), isUrl(), isRegularExpression() y isUuid().

QCborArray QCborValue::toArray() const

QCborArray QCborValue::toArray(const QCborArray &defaultValue) const

Devuelve el valor de la matriz almacenada en este ` QCborValue`, si es de tipo matriz. De lo contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QCborArray`.

Véase también isArray(), isByteArray(), isMap(), isContainer() y toMap().

bool QCborValue::toBool(bool defaultValue = false) const

Devuelve el valor booleano almacenado en este ` QCborValue`, si es de tipo booleano. En caso contrario, devuelve ` defaultValue`.

Véase también isBool(), isTrue() y isFalse().

QByteArray QCborValue::toByteArray(const QByteArray &defaultValue = {}) const

Devuelve el valor de la matriz de bytes almacenada en este ` QCborValue`, si es de tipo matriz de bytes. En caso contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QByteArray`.

Véanse también isByteArray(), isString() y toString().

QByteArray QCborValue::toCbor(QCborValue::EncodingOptions opt = NoTransformation) const

Codifica este objeto ` QCborValue ` a su representación CBOR, utilizando las opciones especificadas en ` opt`, y devuelve la matriz de bytes que contiene dicha representación.

Esta función no fallará, salvo que este ` QCborValue ` o cualquiera de los elementos que contenga —si se trata de un mapa o una matriz— no sean válidos. La API no suele generar tipos no válidos, pero estos pueden ser el resultado de errores de decodificación.

Por defecto, esta función no realiza ninguna transformación sobre los valores de QCborValue, escribiendo todos los valores de coma flotante directamente como tipos de doble precisión (double). Si se especifica la opción UseFloat, utilizará precisión simple (float) para cualquier valor de coma flotante en el que no haya pérdida de precisión al utilizar esa representación. Esto incluye los valores infinitos y NaN.

Del mismo modo, si se especifica « UseFloat16 », esta función intentará utilizar la precisión media (qfloat16) si la conversión a dicha precisión no conlleva pérdida de precisión. Esto siempre es así en el caso de los valores infinitos y NaN.

Si se especifica ` UseIntegers `, utilizará números enteros para cualquier valor de coma flotante que contenga un entero real.

Véanse también fromCbor(), fromVariant() y fromJsonValue().

void QCborValue::toCbor(QCborStreamWriter &writer, QCborValue::EncodingOptions opt = NoTransformation) const

Codifica este objeto ` QCborValue ` a su representación CBOR, utilizando las opciones especificadas en ` opt`, en el escritor especificado por ` writer`. Un mismo escritor puede ser utilizado por varios objetos `QCborValue`, por ejemplo, para codificar diferentes elementos de una matriz más grande.

Esta función no fallará, salvo si este ` QCborValue ` o cualquiera de los elementos que contiene —en caso de que se trate de un mapa o una matriz— no son válidos. La API no suele generar tipos no válidos, pero estos pueden ser el resultado de errores de decodificación.

Por defecto, esta función no realiza ninguna transformación sobre los valores de QCborValue, escribiendo todos los valores de coma flotante directamente como tipos de doble precisión (binary64). Si se especifica la opción UseFloat, utilizará precisión simple (binary32) para cualquier valor de coma flotante en el que no haya pérdida de precisión al utilizar esa representación. Esto incluye los valores infinitos y los valores NaN.

Del mismo modo, si se especifica UseFloat16, esta función intentará utilizar números de coma flotante de media precisión (binary16) si la conversión a ese formato no conlleva pérdida de precisión. Esto siempre es así para los valores infinitos y NaN.

Si se especifica « UseIntegers », utilizará números enteros para cualquier valor de coma flotante que contenga un entero real.

Esta es una función sobrecargada.

Véanse también fromCbor(), fromVariant() y fromJsonValue().

QDateTime QCborValue::toDateTime(const QDateTime &defaultValue = {}) const

Devuelve el valor de fecha y hora almacenado en este ` QCborValue`, si es de tipo «fecha y hora extendida». De lo contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QDateTime`.

Véase también isDateTime(), isTag() y taggedValue().

QString QCborValue::toDiagnosticNotation(QCborValue::DiagnosticNotationOptions opts = Compact) const

Crea la notación de diagnóstico equivalente a este objeto CBOR y la devuelve. El parámetro « opts » controla el dialecto de la notación. La notación de diagnóstico resulta útil en la depuración, ya que ayuda al desarrollador a comprender qué valor se almacena en el objeto ` QCborValue ` o en un flujo CBOR. Por ese motivo, la API de Qt no ofrece soporte para volver a analizar la notación de diagnóstico en el formato en memoria o en un flujo CBOR, aunque la representación es única y sería posible hacerlo.

La notación de diagnóstico CBOR se especifica en la sección 6 del RFC 7049. Se trata de una representación textual del flujo CBOR y es muy similar a JSON, pero admite los tipos CBOR que no se encuentran en JSON. El formato ampliado que habilita el indicador ` ExtendedFormat ` se encuentra actualmente en algunos borradores de la IETF y su formato está sujeto a cambios.

Esta función genera la representación equivalente del flujo que produciría ` toCbor()`, sin ninguna de las opciones de transformación proporcionadas en dicha función. Esto también implica que es posible que esta función no genere una representación del flujo que se utilizó para crear el objeto, si este se creó mediante ` fromCbor()`, ya que dicha función podría haber aplicado transformaciones. Para obtener una notación de alta fidelidad de un flujo, sin transformaciones, véase el ejemplo « cbordump ».

Véanse también « toCbor()» y « QJsonDocument::toJson()».

double QCborValue::toDouble(double defaultValue = 0) const

Devuelve el valor de punto flotante almacenado en este ` QCborValue`, si es de tipo `Double`. Si es de tipo `Integer`, esta función devuelve el valor entero convertido a `double`. En cualquier otro caso, devuelve ` defaultValue`.

Véase también isDouble(), isInteger() y toInteger().

qint64 QCborValue::toInteger(qint64 defaultValue = 0) const

Devuelve el valor entero almacenado en este ` QCborValue`, si es de tipo entero. Si es de tipo `Double`, esta función devuelve el valor de coma flotante convertido a entero. En cualquier otro caso, devuelve ` defaultValue`.

Véanse también isInteger(), isDouble() y toDouble().

QJsonValue QCborValue::toJsonValue() const

Convierte este objeto ` QCborValue ` en una representación equivalente en JSON y lo devuelve como un ` QJsonValue`.

Ten en cuenta que CBOR contiene un conjunto de tipos más amplio y variado que JSON, por lo que es posible que se pierda cierta información en esta conversión. La siguiente tabla compara los tipos de CBOR con los de JSON e indica si puede perderse información o no.

Tipo CBORTipo JSONComentarios
BoolBoolNo es posible la pérdida de datos
DobleNúmeroLos valores infinitos y NaN se convertirán en Null; no se perderán datos para el resto de valores
EnteroNúmeroPuede producirse pérdida de datos en la conversión si el entero es mayor que253 o menor que-253.
NuloNuloNo es posible que se pierdan datos
Sin definirNuloSe ha perdido la información de tipo
CadenaCadenaNo es posible la pérdida de datos
Matriz de bytesCadenaSe convierte a una codificación sin pérdida como Base64url, pero se pierde la distinción entre cadenas y matrices de bytes
Otros tipos simplesCadenaSe pierde la información sobre el tipo
MatrizMatrizLa conversión se aplica a cada valor contenido
MapaObjetoLas claves se convierten a cadena; los valores se convierten según esta tabla
Etiquetas y tipos extendidosEspecialEl número de etiqueta se pierde y el valor etiquetado se convierte a JSON

Para obtener información sobre la conversión de claves de mapa CBOR a cadena, consulte QCborMap::toJsonObject().

Si este ` QCborValue ` contiene el valor «undefined», esta función también devolverá un ` QJsonValue ` «undefined». Tenga en cuenta que JSON no admite valores «undefined» y que los valores «undefined» de QJsonValues son una extensión de la especificación. No pueden almacenarse en un ` QJsonArray ` ni en un ` QJsonObject`, pero pueden devolverse desde funciones para indicar un error. A todos los demás efectos, son equivalentes a «null».

Tratamiento especial de etiquetas y tipos extendidos

Algunas etiquetas se tratan de forma especial y modifican la transformación del valor etiquetado de CBOR a JSON. La siguiente tabla enumera esos casos especiales:

EtiquetaTipo CBORTransformación
ExpectedBase64urlMatriz de bytesCodifica la matriz de bytes como Base64url
ExpectedBase64Matriz de bytesCodifica la matriz de bytes como Base64
ExpectedBase16Matriz de bytesCodifica la matriz de bytes como hexadecimal
URLURL y cadenaUtiliza QUrl::toEncoded() para normalizar la codificación al formato totalmente codificado de la URL
UUIDUuid y matriz de bytesUtiliza ` QUuid::toString()` para crear la representación como cadena

Véase también fromJsonValue(), toVariant(), QCborArray::toJsonArray() y QCborMap::toJsonObject().

QCborMap QCborValue::toMap() const

QCborMap QCborValue::toMap(const QCborMap &defaultValue) const

Devuelve el valor del mapa almacenado en este ` QCborValue`, si es de tipo mapa. De lo contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QCborMap`.

Véase también isMap(), isArray(), isContainer() y toArray().

QRegularExpression QCborValue::toRegularExpression(const QRegularExpression &defaultValue = {}) const

Devuelve el valor de la expresión regular almacenado en este ` QCborValue`, si es de tipo «patrón de expresión regular extendido». De lo contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QRegularExpression`.

Véase también isRegularExpression(), isTag() y taggedValue().

QCborSimpleType QCborValue::toSimpleType(QCborSimpleType defaultValue = QCborSimpleType::Undefined) const

Devuelve el tipo simple al que pertenece « QCborValue », si se trata de un tipo simple. Si no es un tipo simple, devuelve « defaultValue ».

Los siguientes tipos son tipos simples y esta función devolverá los valores indicados:

Véase también type(), isSimpleType(), isBool(), isTrue(), isFalse(), isNull() y isUndefined().

QString QCborValue::toString(const QString &defaultValue = {}) const

Devuelve el valor de cadena almacenado en este ` QCborValue`, si es de tipo cadena. En caso contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QString`.

Véase también toStringView(), isString(), isByteArray() y toByteArray().

[since 6.10] QAnyStringView QCborValue::toStringView(QAnyStringView defaultValue = {}) const

Devuelve el valor de cadena almacenado en este ` QCborValue`, si es de tipo cadena. En caso contrario, devuelve ` defaultValue`. Dado que ` QCborValue ` almacena cadenas en US-ASCII, UTF-8 o UTF-16, el ` QAnyStringView ` devuelto puede estar en cualquiera de estas codificaciones.

Esta función no asigna memoria. El valor devuelto es válido hasta la siguiente llamada a una función miembro no const de este objeto. Si este objeto sale del ámbito, el valor devuelto es válido hasta la siguiente llamada a una función miembro no const del objeto CBOR padre (mapa o matriz).

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a « QString ».

Esta función se introdujo en Qt 6.10.

Véase también toString(), isString(), isByteArray() y toByteArray().

QUrl QCborValue::toUrl(const QUrl &defaultValue = {}) const

Devuelve el valor de la URL almacenado en este ` QCborValue`, si es de tipo URL extendido. En caso contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a ` QUrl`.

Véase también isUrl(), isTag() y taggedValue().

QUuid QCborValue::toUuid(const QUuid &defaultValue = {}) const

Devuelve el valor UUID almacenado en este ` QCborValue`, si es de tipo UUID extendido. En caso contrario, devuelve ` defaultValue`.

Ten en cuenta que esta función no realiza ninguna conversión de otros tipos a « QUuid ».

Véase también isUuid(), isTag() y taggedValue().

QVariant QCborValue::toVariant() const

Convierte este valor a un tipo nativo de Qt y devuelve el ` QVariant` correspondiente.

La siguiente tabla muestra la correspondencia establecida entre ` QCborValue types ` y ` Qt meta types`.

Tipo CBORTipo de Qt o C++Notas
Enteroqint64
Dobledouble
Booleanobool
Nulostd::nullptr_t
Indefinidosin tipo (QVariant())
Matriz de bytesQByteArray
CadenaQString
MatrizQVariantListConvierte de forma recursiva todos los valores
MapaQVariantMapLos tipos de clave se «convierten en cadenas»
Otros tipos simplesQCborSimpleType
DateTimeQDateTime
URLQUrl
RegularExpressionQRegularExpression
UUIDQUuid
Otras etiquetasEspecialLa etiqueta se ignora y el valor etiquetado se convierte mediante esta función

Ten en cuenta que los valores tanto de los mapas CBOR como de las matrices también se convierten de forma recursiva mediante esta función y se colocan en QVariantMap y QVariantList, respectivamente. No encontrarás QCborMap ni QCborArray almacenados dentro de los QVariants.

Los QVariantMaps tienen claves de tipo cadena, a diferencia de CBOR, por lo que la conversión de un QCborMap a un QVariantMap implicará un paso de «conversión a cadena» de los valores de las claves. Véase QCborMap::toJsonObject() para más detalles.

Véanse también fromVariant(), toJsonValue(), QCborArray::toVariantList() y QCborMap::toVariantMap().

QCborValue::Type QCborValue::type() const

Devuelve el tipo de este QCborValue. El tipo también se puede obtener posteriormente mediante una de las funciones «isXxx».

Véase también isInteger(), isByteArray(), isString(), isArray(), isMap(), isTag(), isFalse(), isTrue(), isBool(), isNull(), isUndefined, isDouble(), isDateTime(), isUrl(), isRegularExpression() y isUuid().

[noexcept] QCborValue &QCborValue::operator=(const QCborValue &other)

Sustituye el contenido de este QCborObject por una copia de other.

[noexcept] QCborValue &QCborValue::operator=(QCborValue &&other)

Traslada el contenido del objeto other QCborValue a este y libera los recursos de este último. Devuelve una referencia a este objeto.

Esta es una función sobrecargada.

QCborValueRef QCborValue::operator[](const QString &key)

Devuelve un QCborValueRef que puede utilizarse para leer o modificar la entrada de este mapa, utilizando el key dado. Cuando este QCborValue es un QCborMap, esta función es equivalente al operador [] correspondiente en ese mapa.

Antes de devolver la referencia: si este ` QCborValue ` era una matriz, primero se convierte en un mapa (de modo que ` map[i] ` sea ` array[i] ` para cada índice, ` i`, con ` array[i]` válidos); de lo contrario, si no era un mapa, se sobrescribirá con un mapa vacío.

Véase también operator[](qint64), QCborMap::operator[], QCborMap::value() y QCborMap::find().

const QCborValue QCborValue::operator[](const QString &key) const

Si este QCborValue es un QCborMap, busca en los elementos el valor cuya clave coincida con key. Si no hay ninguna clave que coincida con key en el mapa o si este objeto QCborValue no es un mapa, devuelve el valor «undefined».

Esta función es equivalente a:

value.toMap().value(key);

Véase también operator[](qint64), QCborMap::operator[], QCborMap::value() y QCborMap::find().

QCborValueRef QCborValue::operator[](QLatin1StringView key)

Devuelve un QCborValueRef que se puede utilizar para leer o modificar la entrada de este mapa, utilizando el key dado. Cuando este QCborValue es un QCborMap, esta función es equivalente al operador [] correspondiente en ese mapa.

Antes de devolver la referencia: si este ` QCborValue ` era una matriz, primero se convierte en un mapa (de modo que ` map[i] ` sea ` array[i] ` para cada índice, ` i`, con ` array[i]` válidos); de lo contrario, si no era un mapa, se sobrescribirá con un mapa vacío.

Esta es una función sobrecargada.

Véase también operator[](qint64), QCborMap::operator[], QCborMap::value() y QCborMap::find().

QCborValueRef QCborValue::operator[](qint64 key)

Devuelve un QCborValueRef que puede utilizarse para leer o modificar la entrada de este, ya sea un mapa o una matriz, con el key dado. Cuando este QCborValue es un QCborMap o, para 0 <= clave < 0x10000, un QCborArray, esta función es equivalente al operador [] correspondiente en ese mapa o matriz.

Antes de devolver la referencia: si este QCborValue era un array pero la clave está fuera de rango, el array se convierte primero en un mapa (de modo que map[i] sea array[i] para cada índice, i, con array[i] válidos); de lo contrario, si no era un mapa, se sobrescribirá con un mapa vacío.

Esta es una función sobrecargada.

Véase también operator[], QCborMap::operator[], QCborMap::value(), QCborMap::find(), QCborArray::operator[] y QCborArray::at().

const QCborValue QCborValue::operator[](QLatin1StringView key) const

Si este objeto QCborValue es un QCborMap, busca en los elementos el valor cuya clave coincida con key. Si no hay ninguna clave que coincida con key en el mapa o si este objeto QCborValue no es un mapa, devuelve el valor «undefined».

Esta función es equivalente a:

value.toMap().value(key);

Se trata de una función sobrecargada.

Véase también operator[](qint64), QCborMap::operator[], QCborMap::value() y QCborMap::find().

const QCborValue QCborValue::operator[](qint64 key) const

Si este QCborValue es un QCborMap, busca en los elementos el valor cuya clave coincida con key. Si se trata de un QCborArray, devuelve el elemento cuyo índice sea key. Si no hay ningún valor que coincida en el array o el mapa, o si este objeto QCborValue no es un array ni un mapa, devuelve el valor «undefined».

Esta es una función sobrecargada.

Véase también operator[], QCborMap::operator[], QCborMap::value(), QCborMap::find(), QCborArray::operator[] y QCborArray::at().

Relacionado: No miembros

[noexcept] bool operator!=(const QCborValue &lhs, const QCborValue &rhs)

Compara lhs y rhs, y devuelve «true» si los contenidos difieren; en caso contrario, devuelve «false». Si cada uno de los QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Para obtener más información sobre la igualdad CBOR en Qt, consulta QCborValue::compare().

Véanse también compare(), QCborMap::operator==(), operator==() y operator<().

[noexcept] bool operator<(const QCborValue &lhs, const QCborValue &rhs)

Compara lhs y rhs, y devuelve «true» si lhs debe ordenarse antes que rhs; en caso contrario, devuelve «false». Si cada QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Para obtener más información sobre el orden de clasificación CBOR, véase QCborValue::compare().

Véase también compare(), QCborValue::operator==(), QCborMap::operator==(), operator==() y operator!=().

[noexcept] bool operator<=(const QCborValue &lhs, const QCborValue &rhs)

Compara lhs y rhs, y devuelve «true» si lhs debe ordenarse antes que rhs o es igual a rhs; en caso contrario, devuelve «false». Si cada QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Para obtener más información sobre el orden de clasificación de CBOR, consulta QCborValue::compare().

Véase también compare(), QCborValue::operator<(), QCborMap::operator==(), operator==() y operator!=().

[noexcept] bool operator==(const QCborValue &lhs, const QCborValue &rhs)

Compara lhs y rhs, y devuelve «true» si tienen el mismo contenido; en caso contrario, devuelve «false». Si cada QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Para obtener más información sobre la igualdad CBOR en Qt, consulta compare().

Véanse también compare(), QCborMap::operator==(), operator!=() y operator<().

[noexcept] bool operator>(const QCborValue &lhs, const QCborValue &rhs)

Compara lhs y rhs, y devuelve «true» si lhs debe ordenarse después de rhs; en caso contrario, devuelve «false». Si cada QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Para obtener más información sobre el orden de clasificación CBOR, véase QCborValue::compare().

Véase también compare(), QCborValue::operator>=(), QCborMap::operator==(), operator==() y operator!=().

[noexcept] bool operator>=(const QCborValue &lhs, const QCborValue &rhs)

Compara lhs y rhs, y devuelve «true» si lhs debe ordenarse después de rhs o es igual a rhs; en caso contrario, devuelve «false». Si cada QCborValue contiene una matriz o un mapa, la comparación se realiza de forma recursiva sobre los elementos que contienen.

Para obtener más información sobre el orden de clasificación CBOR, consulta QCborValue::compare().

Véanse también compare(), QCborValue::operator>(), QCborMap::operator==(), operator==() y operator!=().

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