QCborValue Class

Documentación de las funciones miembro

QCborValue::QCborValue()

Crea un QCborValue del tipo Undefined.

Los valores indefinidos CBOR se utilizan para indicar que falta información, normalmente como resultado de una operación anterior que no se completó como se esperaba. También los utilizan las API QCborArray y QCborMap para indicar que no se ha encontrado el elemento buscado.

Los valores indefinidos están representados por la API Undefined simple type. Por ello, los QCborValues con valores indefinidos también devolverán verdadero para isSimpleType() y isSimpleType(QCborSimpleType::Undefined).

Los valores indefinidos son diferentes de los valores nulos.

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

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

QCborValue::QCborValue(QCborSimpleType st)

Crea un QCborValue de tipo simple st. El tipo puede recuperarse posteriormente utilizando toSimpleType() así como 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á del tipo Null y de forma similar para QCborSimpleType::Undefined. Si st es QCborSimpleType::False o QCborSimpleType::True, el QCborValue creado será un booleano que contendrá un valor de falso o verdadero, respectivamente.

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

QCborValue value(QCborSimpleType(12));

Los tipos simples no deben utilizarse hasta que se haya publicado una especificación para ellos, ya que otras implementaciones podrían no soportarlos adecuadamente. Los valores de tipo simple 24 a 31 están reservados y no deben utilizarse.

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

QCborValue::QCborValue(QCborValue::Type t_)

Crea un QCborValue de tipo t_. El valor asociado a dicho tipo (si existe) se construirá por defecto.

Véase también type().

QCborValue::QCborValue(QStringView s)

Crea un QCborValue con valor de cadena s. El valor puede recuperarse posteriormente utilizando toString().

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

QCborValue::QCborValue(bool b)

Crea un QCborValue con valor booleano b. El valor puede recuperarse posteriormente utilizando toBool().

Internamente, los booleanos CBOR se representan mediante un par de tipos, uno para verdadero y otro para falso. Por esa razón, los booleanos QCborValues devolverán verdadero para isSimpleType() y uno de isSimpleType(QCborSimpleType::False) o isSimpleType(QCborSimpleType::True).

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

QCborValue::QCborValue(const QByteArray &ba)

Crea un QCborValue con valor de matriz de bytes ba. El valor puede recuperarse posteriormente utilizando toByteArray().

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

Crea un QCborValue con la matriz a. El array puede recuperarse posteriormente utilizando toArray().

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

Crea un QCborValue con el mapa m. El mapa puede recuperarse posteriormente utilizando toMap().

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

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

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

Los tipos de fecha/hora CBOR son tipos de extensión que utilizan etiquetas: una cadena (en formato de fecha ISO) etiquetada como DateTime o 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 cadena.

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

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

Crea un objeto QCborValue del tipo extendido patrón de expresión regular y que contiene el valor representado por rx. El valor puede recuperarse posteriormente utilizando toRegularExpression().

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

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

QCborValue::QCborValue(const QString &s)

Crea un QCborValue con valor de cadena s. El valor puede recuperarse posteriormente utilizando toString().

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

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

Crea un objeto QCborValue del tipo extendido URL y que contiene el valor representado por url. El valor puede recuperarse posteriormente utilizando toUrl().

El tipo CBOR URL es un tipo extendido 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 y que contiene el valor representado por uuid. El valor puede recuperarse posteriormente utilizando 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().

QCborValue::QCborValue(double d)

Crea un QCborValue con valor de coma flotante d. El valor puede recuperarse posteriormente utilizando toDouble().

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

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

QCborValue::QCborValue(qint64 i)

Crea un QCborValue con valor entero i. El valor puede recuperarse posteriormente utilizando toInteger().

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

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

QCborValue::QCborValue(std::nullptr_t)

Crea un QCborValue del tipo Null.

Los valores nulos 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().

Crea un QCborValue para el tipo extendido representado por el valor de etiqueta tag, valor de etiqueta tv. La etiqueta puede recuperarse posteriormente mediante tag() y el valor etiquetado mediante taggedValue().

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

QCborValue::QCborValue(QLatin1StringView s)

Crea un QCborValue con la cadena Latin-1 vista por s. El valor puede recuperarse posteriormente utilizando toString().

Véase 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)

Mueve el contenido del objeto other QCborValue a éste y libera los recursos de éste.

[noexcept] QCborValue::~QCborValue()

Elimina el objeto QCborValue actual y libera los recursos asociados.

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

Compara este valor y 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 un array o un mapa, la comparación es recursiva a los elementos contenidos en ellos.

Tipos extendidos

QCborValue compara igual 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");

Tenga en cuenta que los tipos Qt como QUrl y QDateTime normalizarán y modificarán de otro modo sus argumentos. La expresión anterior es verdadera sólo porque la cadena de la derecha es el valor normalizado que tomaría el QCborValue de la izquierda. Si, por ejemplo, la parte "https" estuviera en mayúsculas en ambos lados, la comparación fallaría. Para más información sobre las normalizaciones realizadas por QCborValue, consulte la documentación del constructor que toma el tipo Qt en cuestión.

Orden de clasificación

El orden de clasificación en CBOR se define en el RFC 7049, sección 3.9, que trata de la clasificación de claves en un mapa cuando se sigue la codificación canónica. Según la especificación, "la ordenación se realiza en los bytes de la representación de los elementos de datos 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 de menor valor en orden léxico (byte a byte) se ordena antes".

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

La especificación no indica claramente qué orden de clasificación debe hacerse para valores de distintos tipos (dice que la clasificación no debe prestar "atención a la división de 3/5 bits para los tipos principales"). QCborValue asume que los tipos también deben ordenarse. Los valores numéricos de la enumeración QCborValue::Type están en ese orden, con la excepción de los tipos extendidos, que se comparan como sus equivalentes etiquetados.

Véase 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, descodificará todos los elementos encontrados en ese mapa o matriz, hasta terminar con 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 aunque la descodificación haya fallado. Para determinar si hubo un error, compruebe si reader.lastError() está indicando una condición de error. Esta función detiene la descodificación inmediatamente después del primer error.

Véase 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 matriz, decodificará todos los elementos encontrados en ese mapa o matriz, hasta terminar con el objeto más externo.

Esta función almacena el estado de error, si lo hay, en el objeto apuntado por error, junto con el desplazamiento del lugar donde se produjo el error. Si no se produjo ningún error, almacena NoError en el estado de error y el número de bytes que consumió (es decir, almacena el desplazamiento del primer byte no utilizado). El uso de esta información permite analizar otros datos que puedan existir en la misma matriz de bytes.

El valor devuelto puede estar parcialmente completo y ser indistinguible de un QCborValue válido aunque la descodificación haya fallado. Para determinar si hubo un error, compruebe si hubo un error almacenado en error. Esta función detiene la descodificación inmediatamente después del primer error.

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

Convierte len bytes de data a un QByteArray y luego llama a la sobrecarga de esta función que acepta un QByteArray, pasando también error, si se proporciona.

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

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

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

QJsonValue también puede ser indefinido, indicando una operación anterior que no se completó (por ejemplo, la búsqueda de una clave no presente en un objeto). Los valores indefinidos no son tipos JSON y no pueden aparecer en arrays y objetos JSON, pero esta función devuelve el valor indefinido QCborValue si el correspondiente QJsonValue está indefinido.

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

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

Convierte el QVariant variant en QCborValue y lo devuelve.

QVariants puede contener una gran 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 utilizando CBOR, se sugiere codificar cuidadosamente cada valor para evitar la pérdida de representación.

La siguiente tabla enumera la conversión que aplicará esta función:

Si QVariant::isNull() devuelve verdadero, se devuelve un QCborValue nulo o se inserta en la lista u objeto, independientemente del tipo que lleve QVariant. Observe 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 listados anteriormente, se intentará una conversión a cadena, normalmente pero no siempre llamando a QVariant::toString(). Si la conversión falla, el valor se sustituye por un valor CBOR indefinido. Tenga en cuenta que QVariant::toString() también tiene pérdidas para la mayoría de los tipos.

Tenga en cuenta que las conversiones mediante QVariant::toString() están sujetas a cambios en cualquier momento. Tanto QVariant como QCborValue pueden ampliarse en el futuro para admitir más tipos, lo que provocará 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 QCborValue es de tipo array. El valor del array se puede recuperar utilizando toArray().

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

bool QCborValue::isBool() const

Devuelve true si este QCborValue es un booleano. El valor puede recuperarse utilizando toBool().

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

bool QCborValue::isByteArray() const

Devuelve true si este QCborValue es de tipo matriz de bytes. El valor de la matriz de bytes puede recuperarse utilizando toByteArray().

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

bool QCborValue::isContainer() const

Esta función devuelve verdadero si QCborValue es una matriz o un mapa.

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

bool QCborValue::isDateTime() const

Devuelve true si este QCborValue es del tipo fecha/hora. El valor puede recuperarse utilizando toDateTime(). Las fechas/horas son tipos extendidos que utilizan la etiqueta DateTime.

Además, al descodificar desde un flujo CBOR, QCborValue interpretará las etiquetas de valor UnixTime_t y las convertirá en la fecha/hora equivalente.

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

bool QCborValue::isDouble() const

Devuelve true si este QCborValue es de tipo punto flotante. El valor puede recuperarse utilizando toDouble().

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

bool QCborValue::isFalse() const

Devuelve verdadero si este QCborValue es un booleano con valor falso. Esta función existe porque, internamente, los booleanos CBOR se almacenan como dos tipos separados, uno para verdadero y otro para falso.

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

bool QCborValue::isInteger() const

Devuelve true si este QCborValue es de tipo entero. El valor entero puede recuperarse utilizando toInteger().

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

bool QCborValue::isInvalid() const

Devuelve true si este QCborValue no es de ningún tipo válido. Los QCborValues inválidos son distintos de aquellos con valores indefinidos y normalmente representan un error de decodificación.

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

bool QCborValue::isMap() const

Devuelve true si este QCborValue es de tipo map. El valor del mapa puede recuperarse utilizando toMap().

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

bool QCborValue::isNull() const

Devuelve true si este QCborValue es de tipo null.

Los valores nulos 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 son distintos de los valores indefinidos y de los objetos QCborValue no válidos. La API no creará QCborValues no válidos, pero pueden existir como resultado de un error de análisis.

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

bool QCborValue::isRegularExpression() const

Devuelve true si este QCborValue contiene un patrón de expresión regular. El patrón puede recuperarse utilizando toRegularExpression().

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

bool QCborValue::isSimpleType() const

Devuelve true si este QCborValue es de uno de los tipos simples CBOR. El tipo en sí puede recuperarse posteriormente utilizando type(), incluso para tipos que no tienen una enumeración en la API. También pueden comprobarse con la sobrecarga isSimpleType(QCborSimpleType).

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

bool QCborValue::isSimpleType(QCborSimpleType st) const

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

value.isSimpleType(QCborSimpleType(12));

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

bool QCborValue::isString() const

Devuelve true si este QCborValue es de tipo string. El valor de la cadena puede recuperarse utilizando toString().

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

bool QCborValue::isTag() const

Devuelve true si este QCborValue es del tipo tag. El valor de la etiqueta puede recuperarse utilizando tag() y el valor etiquetado utilizando taggedValue().

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

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

bool QCborValue::isTrue() const

Devuelve verdadero si este QCborValue es un booleano con valor verdadero. Esta función existe porque, internamente, los booleanos CBOR se almacenan como dos tipos separados, uno para falso y otro para verdadero.

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

bool QCborValue::isUndefined() const

Devuelve verdadero si este QCborValue es de tipo indefinido.

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ó como se esperaba. También se utilizan en 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á QCborValues no válidos, pero 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 QCborValue es de tipo URL. El valor de la URL puede recuperarse utilizando toUrl().

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

bool QCborValue::isUuid() const

Devuelve true si este QCborValue contiene un UUID. El valor puede recuperarse utilizando 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 extendido QCborValue, si es del tipo etiqueta, defaultValue en caso contrario.

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 extendido QCborValue, si es del tipo etiquetado, defaultValue en caso contrario.

CBOR representa tipos extendidos asociando un número (la etiqueta) con 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().

Devuelve el valor del array almacenado en este QCborValue, si es del tipo array. En caso contrario, devuelve defaultValue.

Tenga 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 del tipo matriz de bytes. En caso contrario, devuelve defaultValue.

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

Véase 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á, excepto si este QCborValue o cualquiera de los elementos contenidos, si se trata de un mapa o matriz, no son válidos. Los tipos inválidos no son producidos normalmente por la API, pero pueden resultar de errores de decodificación.

Por defecto, esta función no realiza ninguna transformación en los valores de QCborValue, escribiendo todos los puntos flotantes 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 para el que no haya pérdida de precisión al utilizar esa representación. Esto incluye infinitos y valores NaN.

Del mismo modo, si se especifica UseFloat16, esta función intentará utilizar media precisión (qfloat16) en coma flotante si la conversión a la misma no conlleva pérdida de precisión. Esto es siempre cierto para infinitos y NaN.

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

Véase 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, al escritor especificado por writer. El mismo escritor puede ser usado por múltiples QCborValues, por ejemplo, para codificar diferentes elementos en un array mayor.

Esta función no fallará, excepto si este QCborValue o cualquiera de los elementos contenidos, si se trata de un mapa o array, no son válidos. Los tipos inválidos no son producidos normalmente por la API, pero pueden resultar de errores de decodificación.

Por defecto, esta función no realiza ninguna transformación en los valores de QCborValue, escribiendo todos los puntos flotantes 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 para el que no haya pérdida de precisión al utilizar esa representación. Esto incluye infinitos y valores NaN.

Del mismo modo, si se especifica UseFloat16, esta función tratará de utilizar media precisión (binary16) de punto flotante si la conversión a que no resulta en la pérdida de precisión. Esto es siempre cierto para infinitos y NaN.

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

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

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

Devuelve el valor de fecha/hora almacenado en este QCborValue, si es del tipo extendido fecha/hora. En caso contrario, devuelve defaultValue.

Tenga 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 es útil en la depuración, para ayudar al desarrollador a comprender qué valor se almacena en QCborValue o en un flujo CBOR. Por esa razón, la API de Qt no proporciona soporte para analizar el diagnóstico de nuevo en el formato en memoria o flujo CBOR, aunque la representación es única y sería posible.

La notación de diagnóstico CBOR se especifica en la sección 6 del RFC 7049. Es una representación de texto del flujo CBOR y es muy similar a JSON, pero soporta los tipos CBOR que no se encuentran en JSON. El formato extendido habilitado por la bandera ExtendedFormat se encuentra actualmente en algunos borradores del IETF y su formato está sujeto a cambios.

Esta función produce la representación equivalente del flujo que produciría toCbor(), sin ninguna opción de transformación proporcionada allí. Esto también implica que esta función puede no producir una representación del flujo que se utilizó para crear el objeto, si se creó utilizando fromCbor(), ya que esa función puede haber aplicado transformaciones. Para una notación de alta fidelidad de un flujo, sin transformación, véase el ejemplo cbordump.

Véase también toCbor() y QJsonDocument::toJson().

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

Devuelve el valor en coma 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 en coma flotante convertido a entero. En cualquier otro caso, devuelve defaultValue.

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

QJsonValue QCborValue::toJsonValue() const

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

Tenga en cuenta que CBOR contiene un conjunto de tipos más rico y amplio que JSON, por lo que puede perderse algo de información en esta conversión. La siguiente tabla compara los tipos CBOR con los tipos JSON e indica si se puede perder información o no.

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

Si este QCborValue contiene el valor indefinido, esta función devolverá un QJsonValue indefinido también. Tenga en cuenta que JSON no admite valores indefinidos y que los QJsonValues indefinidos son una extensión de la especificación. No pueden mantenerse en QJsonArray o QJsonObject, pero pueden devolverse desde funciones para indicar un fallo. A todos los demás efectos, son iguales que null.

Tratamiento especial de etiquetas y tipos extendidos

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

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

Devuelve el valor del mapa almacenado en este QCborValue, si es del tipo mapa. En caso contrario, devuelve defaultValue.

Tenga 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 expresión regular almacenado en este QCborValue, si es del tipo extendido de patrón de expresión regular. En caso contrario, devuelve defaultValue.

Tenga 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 de este QCborValue, si es un tipo simple. Si no es un tipo simple, devuelve defaultValue.

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

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.

Tenga 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 de retorno es válido hasta la siguiente llamada a una función miembro no-const del objeto CBOR padre (mapa o matriz).

Observe 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 URL almacenado en este QCborValue, si es del tipo URL extendido. En caso contrario, devuelve defaultValue.

Tenga 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 del tipo extendido UUID. En caso contrario, devuelve defaultValue.

Tenga 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 correspondiente QVariant.

La siguiente tabla enumera el mapeo realizado entre QCborValue types y Qt meta types.

Tenga en cuenta que los valores tanto en CBOR Maps como en Arrays se convierten recursivamente utilizando esta función también y se colocan en QVariantMap y QVariantList en su lugar. No encontrarás QCborMap y QCborArray almacenados dentro de las QVariants.

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

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

QCborValue::Type QCborValue::type() const

Devuelve el tipo de este QCborValue. El tipo también puede recuperarse 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)

Mueve el contenido del objeto other QCborValue a éste y libera los recursos de éste. Devuelve una referencia a este objeto.

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

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

Antes de devolver la referencia: si este QCborValue era un array, primero se convierte en un mapa (de forma que map[i] es array[i] para cada índice, i, con array[i] válido ); en caso contrario, si no era un mapa se sobreescribirá 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 coincide 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 indefinido.

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 puede usarse para leer o modificar la entrada en this, como un mapa, con el key dado. Cuando este QCborValue es un QCborMap, esta función es equivalente al operador de correspondencia[] en ese mapa.

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

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

QCborValueRef QCborValue::operator[](qint64 key)

Devuelve un QCborValueRef que puede usarse para leer o modificar la entrada en this, como un mapa o array, con el key dado. Cuando este QCborValue es un QCborMap o, para 0 <= clave < 0x10000, un QCborArray, esta función es equivalente al operador de correspondencia[] en ese mapa o array.

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] es array[i] para cada índice, i, con array[i] válido ); de lo contrario, si no era un mapa se sobreescribirá con un mapa vacío.

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 QCborValue es un QCborMap, busca en los elementos el valor cuya clave coincide 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 indefinido.

Esta función es equivalente a:

value.toMap().value(key);

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 coincide con key. Si esto es un QCborArray, devuelve el elemento cuyo índice es key. Si no hay ningún valor coincidente en el array o mapa, o si este objeto QCborValue no es un array o mapa, devuelve el valor indefinido.

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