QCborMap Class
La clase QCborMap se utiliza para almacenar un contenedor asociativo que se puede representar en CBOR. Más información...
| Encabezado: | #include <QCborMap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QCborMap forma parte del soporte CBOR de Qt.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QCborMap
| Categoría | Tipos comparables |
|---|---|
| strong | QCborMap |
| strong | QCborValue y QCborValueConstRef. |
Tipos públicos
| class | ConstIterator |
| class | Iterator |
| const_iterator | |
(since 6.10) | const_key_value_iterator |
| iterator | |
| key_type | |
(since 6.10) | key_value_iterator |
| mapped_type | |
| size_type | |
| value_type |
Funciones públicas
| QCborMap() | |
| QCborMap(std::initializer_list<QCborMap::value_type> args) | |
| QCborMap(const QCborMap &other) | |
(since 6.10) | QCborMap(QCborMap &&other) |
| ~QCborMap() | |
(since 6.10) auto | asKeyValueRange() && |
(since 6.10) auto | asKeyValueRange() & |
(since 6.10) auto | asKeyValueRange() const && |
(since 6.10) auto | asKeyValueRange() const & |
| QCborMap::iterator | begin() |
| QCborMap::const_iterator | begin() const |
| QCborMap::const_iterator | cbegin() const |
| QCborMap::const_iterator | cend() const |
| void | clear() |
| int | compare(const QCborMap &other) const |
| QCborMap::const_iterator | constBegin() const |
| QCborMap::const_iterator | constEnd() const |
| QCborMap::const_iterator | constFind(qint64 key) const |
| QCborMap::const_iterator | constFind(QLatin1StringView key) const |
| QCborMap::const_iterator | constFind(const QCborValue &key) const |
| QCborMap::const_iterator | constFind(const QString &key) const |
(since 6.10) QCborMap::const_key_value_iterator | constKeyValueBegin() const |
(since 6.10) QCborMap::const_key_value_iterator | constKeyValueEnd() const |
| bool | contains(const QCborValue &key) const |
| bool | contains(qint64 key) const |
| bool | contains(QLatin1StringView key) const |
| bool | contains(const QString &key) const |
| bool | empty() const |
| QCborMap::iterator | end() |
| QCborMap::const_iterator | end() const |
| QCborMap::iterator | erase(QCborMap::const_iterator it) |
| QCborMap::iterator | erase(QCborMap::iterator it) |
| QCborValue | extract(QCborMap::const_iterator it) |
| QCborValue | extract(QCborMap::iterator it) |
| QCborMap::iterator | find(qint64 key) |
| QCborMap::const_iterator | find(qint64 key) const |
| QCborMap::iterator | find(QLatin1StringView key) |
| QCborMap::iterator | find(const QCborValue &key) |
| QCborMap::iterator | find(const QString &key) |
| QCborMap::const_iterator | find(QLatin1StringView key) const |
| QCborMap::const_iterator | find(const QCborValue &key) const |
| QCborMap::const_iterator | find(const QString &key) const |
| QCborMap::iterator | insert(QCborMap::value_type v) |
| QCborMap::iterator | insert(QLatin1StringView key, const QCborValue &value) |
| QCborMap::iterator | insert(const QCborValue &key, const QCborValue &value) |
| QCborMap::iterator | insert(const QString &key, const QCborValue &value) |
| QCborMap::iterator | insert(qint64 key, const QCborValue &value) |
| bool | isEmpty() const |
(since 6.10) QCborMap::key_value_iterator | keyValueBegin() |
(since 6.10) QCborMap::const_key_value_iterator | keyValueBegin() const |
(since 6.10) QCborMap::key_value_iterator | keyValueEnd() |
(since 6.10) QCborMap::const_key_value_iterator | keyValueEnd() const |
| QList<QCborValue> | keys() const |
| void | remove(const QCborValue &key) |
| void | remove(qint64 key) |
| void | remove(QLatin1StringView key) |
| void | remove(const QString &key) |
| qsizetype | size() const |
| void | swap(QCborMap &other) |
| QCborValue | take(QLatin1StringView key) |
| QCborValue | take(const QCborValue &key) |
| QCborValue | take(const QString &key) |
| QCborValue | take(qint64 key) |
| QCborValue | toCborValue() const |
| QJsonObject | toJsonObject() const |
| QVariantHash | toVariantHash() const |
| QVariantMap | toVariantMap() const |
| QCborValue | value(const QCborValue &key) const |
| QCborValue | value(qint64 key) const |
| QCborValue | value(QLatin1StringView key) const |
| QCborValue | value(const QString &key) const |
(since 6.10) QCborMap & | operator=(QCborMap &&other) |
| QCborMap & | operator=(const QCborMap &other) |
| QCborValueRef | operator[](qint64 key) |
| const QCborValue | operator[](const QCborValue &key) const |
| const QCborValue | operator[](qint64 key) const |
| QCborValueRef | operator[](QLatin1StringView key) |
| QCborValueRef | operator[](const QCborValue &key) |
| QCborValueRef | operator[](const QString &key) |
| const QCborValue | operator[](QLatin1StringView key) const |
| const QCborValue | operator[](const QString &key) const |
Miembros públicos estáticos
| QCborMap | fromJsonObject(const QJsonObject &obj) |
(since 6.3) QCborMap | fromJsonObject(QJsonObject &&obj) |
| QCborMap | fromVariantHash(const QVariantHash &hash) |
| QCborMap | fromVariantMap(const QVariantMap &map) |
Elementos no miembros relacionados
| bool | operator!=(const QCborMap &lhs, const QCborMap &rhs) |
| bool | operator<(const QCborMap &lhs, const QCborMap &rhs) |
| bool | operator<=(const QCborMap &lhs, const QCborMap &rhs) |
| bool | operator==(const QCborMap &lhs, const QCborMap &rhs) |
| bool | operator>(const QCborMap &lhs, const QCborMap &rhs) |
| bool | operator>=(const QCborMap &lhs, const QCborMap &rhs) |
Descripción detallada
Esta clase se puede utilizar para almacenar un contenedor asociativo en CBOR, es decir, una correspondencia entre una clave y un tipo de valor. 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 RFC nuevos. Está pensado para utilizarse junto con el protocolo CoAP.
A diferencia de JSON y QVariantMap, las claves de los mapas CBOR pueden ser de cualquier tipo, no solo cadenas. Por ese motivo, QCborMap es, en la práctica, un mapa entre claves de tipo QCborValue y elementos de valor de tipo QCborValue.
Sin embargo, para todas las funciones miembro que admiten un parámetro de clave, QCborMap proporciona sobrecargas que funcionan de manera eficiente con enteros y cadenas de caracteres. De hecho, se recomienda el uso de claves enteras, ya que ocupan menos bytes al transmitirlas y son más sencillas de codificar y descodificar. Se sabe que los protocolos más recientes diseñados por el grupo de trabajo CoRE de la IETF para funcionar específicamente con CBOR las utilizan.
QCborMap no está ordenado; por ello, la búsqueda de claves tiene una complejidad lineal (O(n)). En realidad, QCborMap mantiene los elementos en el orden en que se insertaron, lo que significa que es posible crear QCborMaps ordenados insertando cuidadosamente los elementos en orden. CBOR no exige la ordenación, pero la recomienda.
QCborMap también se puede convertir a y des QVariantMap y QJsonObject. Sin embargo, al realizar la conversión, cualquier clave que no sea una cadena se convertirá en cadena mediante un método unidireccional que la conversión de vuelta a QCborMap no revertirá.
Véase también QCborArray, QCborValue, QJsonDocument, QVariantMap, «Análisis y visualización de datos CBOR», «Convertidor de serialización» y «Guardar y cargar una partida».
Documentación sobre tipos de miembros
QCborMap::const_iterator
Un sinónimo de QCborMap::ConstIterator
[since 6.10] QCborMap::const_key_value_iterator
La definición de tipo `QCborMap::const_key_value_iterator` proporciona un iterador al estilo STL para ` QCborMap`.
QCborMap::const_key_value_iterator es, en esencia, lo mismo que QCborMap::const_iterator, pero se proporciona para mantener la simetría con otros contenedores como QJsonObject.
Esta definición de tipo se introdujo en Qt 6.10.
Véase también ` QKeyValueIterator`.
QCborMap::iterator
Sinónimo de « QCborMap::Iterator ».
QCborMap::key_type
El tipo de clave para este mapa. Dado que las claves de « QCborMap » pueden ser de cualquier tipo CBOR, se trata de una « QCborValue ».
[since 6.10] QCborMap::key_value_iterator
La definición de tipo `QCborMap::key_value_iterator` proporciona un iterador al estilo STL para ` QCborMap`.
QCborMap::key_value_iterator es esencialmente lo mismo que QCborMap::iterator, pero se proporciona para mantener la simetría con otros contenedores como QJsonObject.
Esta definición de tipo se introdujo en Qt 6.10.
Véase también QKeyValueIterator.
QCborMap::mapped_type
El tipo al que se asigna (el valor), es decir, un QCborValue.
QCborMap::size_type
El tipo que utiliza QCborMap para indicar las tallas.
QCborMap::value_type
El valor que se almacena en este contenedor: un par de QCborValues
Documentación de las funciones de miembro
[noexcept] QCborMap::QCborMap()
Crea un objeto CBOR Map vacío.
Véase también ` isEmpty()`.
QCborMap::QCborMap(std::initializer_list<QCborMap::value_type> args)
Crea un objeto QCborMap con los elementos de una lista de inicialización entre llaves que se encuentra en args, tal y como se muestra en el siguiente ejemplo:
QCborMap map = {
{0, "Hello"},
{1, "World"},
{"foo", nullptr},
{"bar", QCborArray{0, 1, 2, 3, 4}}
};[noexcept] QCborMap::QCborMap(const QCborMap &other)
Crea un objeto QCborMap que es una copia de other.
[constexpr noexcept default, since 6.10] QCborMap::QCborMap(QCborMap &&other)
Constructor de traspaso.
El objeto del que se realiza el traslado other se coloca en el estado de construcción por defecto.
Esta función se introdujo en Qt 6.10.
Véase también QCborMap::QCborMap().
[noexcept] QCborMap::~QCborMap()
Destruye este objeto ` QCborMap ` y libera todos los recursos asociados que le pertenecen.
[since 6.10] auto QCborMap::asKeyValueRange() &&
[since 6.10] auto QCborMap::asKeyValueRange() &
[since 6.10] auto QCborMap::asKeyValueRange() const &&
[since 6.10] auto QCborMap::asKeyValueRange() const &
Devuelve un objeto de rango que permite iterar sobre este mapa como pares clave/valor.
Ten en cuenta que los valores obtenidos de esta forma son referencias a los que se encuentran en el mapa. Concretamente, al modificar el valor se modificará el propio mapa.
Estas funciones se introdujeron en Qt 6.10.
Véase también QKeyValueIterator.
QCborMap::iterator QCborMap::begin()
Devuelve un iterador de mapa que apunta al primer par clave-valor de este mapa. Si el mapa está vacío, el iterador devuelto será el mismo que el de end().
Véase también constBegin() y end().
QCborMap::const_iterator QCborMap::begin() const
Devuelve un iterador de mapa que apunta al primer par clave-valor de este mapa. Si este mapa está vacío, el iterador devuelto será el mismo que el de constEnd().
Véase también cbegin() y constEnd().
QCborMap::const_iterator QCborMap::cbegin() const
Devuelve un iterador de mapa que apunta al primer par clave-valor de este mapa. Si este mapa está vacío, el iterador devuelto será el mismo que el de constEnd().
Véase también begin() y constEnd().
QCborMap::const_iterator QCborMap::cend() const
Devuelve un iterador de mapa que representa un elemento situado justo después del último elemento del mapa.
Véase también begin(), constBegin(), find() y constFind().
void QCborMap::clear()
Vacía este mapa.
Véase también isEmpty().
[noexcept] int QCborMap::compare(const QCborMap &other) const
Compara este mapa con other, comparando cada elemento de forma secuencial, y devuelve un número entero que indica si este mapa 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 mapas son iguales y contienen los mismos elementos.
Ten en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por orden ascendente del valor de la clave. De hecho, para la representación canónica CBOR se requieren mapas con las claves ordenadas.
Para obtener más información sobre el orden de clasificación CBOR, consulta QCborValue::compare().
Véase también QCborValue::compare(), QCborArray::compare() y operator==().
QCborMap::const_iterator QCborMap::constBegin() const
Devuelve un iterador de mapa que apunta al primer par clave-valor de este mapa. Si este mapa está vacío, el iterador devuelto será el mismo que el de constEnd().
Véase también begin() y constEnd().
QCborMap::const_iterator QCborMap::constEnd() const
Devuelve un iterador del mapa que representa un elemento situado justo después del último elemento del mapa.
Véase también begin(), constBegin(), find() y constFind().
QCborMap::const_iterator QCborMap::constFind(qint64 key) const
Devuelve un iterador del mapa para el par clave-valor cuya clave es key, si el mapa contiene dicho par. Si no lo contiene, esta función devuelve constEnd().
CBOR recomienda utilizar claves enteras, ya que ocupan menos espacio y son más sencillas de codificar y descodificar.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &) y value(const QCborValue &).
QCborMap::const_iterator QCborMap::constFind(QLatin1StringView key) const
Devuelve un iterador de mapa que apunta al par clave-valor cuya clave es « key », si el mapa contiene dicho par. Si no lo contiene, esta función devuelve « constEnd()».
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &) y value(const QCborValue &).
QCborMap::const_iterator QCborMap::constFind(const QCborValue &key) const
Devuelve un iterador del mapa que apunta al par clave-valor cuya clave es key, si el mapa contiene dicho par. Si no lo contiene, esta función devuelve constEnd().
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView) y value(const QString &).
QCborMap::const_iterator QCborMap::constFind(const QString &key) const
Devuelve un iterador del mapa que apunta al par clave-valor cuya clave es « key », si el mapa contiene dicho par. Si no lo contiene, esta función devuelve ` constEnd()`.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView) y value(const QCborValue &).
[since 6.10] QCborMap::const_key_value_iterator QCborMap::constKeyValueBegin() const
Devuelve un iterador constante al estilo STL que apunta a la primera entrada del mapa.
Esta función se introdujo en Qt 6.10.
Véase también keyValueBegin().
[since 6.10] QCborMap::const_key_value_iterator QCborMap::constKeyValueEnd() const
Devuelve un iterador constante al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del mapa.
Esta función se introdujo en Qt 6.10.
Véase también ` constKeyValueBegin()`.
bool QCborMap::contains(const QCborValue &key) const
Devuelve «true» si este mapa contiene un par clave-valor identificado por la clave « key ».
Véase también value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(qint64), remove(QLatin1StringView) y remove(const QString &).
bool QCborMap::contains(qint64 key) const
Devuelve «true» si este mapa contiene un par clave-valor identificado por la clave « key ». CBOR recomienda utilizar claves enteras, ya que ocupan menos espacio y son más sencillas de codificar y descodificar.
Véase también value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(QLatin1StringView), remove(const QString &) y remove(const QCborValue &).
bool QCborMap::contains(QLatin1StringView key) const
Devuelve «true» si este mapa contiene un par clave-valor identificado por la clave « key ».
Esta es una función sobrecargada.
Véase también value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(qint64), remove(const QString &) y remove(const QCborValue &).
bool QCborMap::contains(const QString &key) const
Devuelve «true» si este mapa contiene un par clave-valor identificado por la clave « key ».
Esta es una función sobrecargada.
Véase también value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(qint64), remove(QLatin1StringView) y remove(const QCborValue &).
bool QCborMap::empty() const
Sinónimo de ` isEmpty()`. Esta función se proporciona para garantizar la compatibilidad con el código genérico que utiliza la API de la biblioteca estándar.
Devuelve «true» si este mapa está vacío (size() == 0).
Véanse también isEmpty() y size().
QCborMap::iterator QCborMap::end()
Devuelve un iterador del mapa que representa un elemento situado justo después del último elemento del mapa.
Véase también begin(), constBegin(), find() y constFind().
QCborMap::const_iterator QCborMap::end() const
Devuelve un iterador de mapa que representa un elemento situado justo después del último elemento del mapa.
Véase también begin(), constBegin(), find() y constFind().
QCborMap::iterator QCborMap::erase(QCborMap::const_iterator it)
Elimina el par clave-valor al que apunta el iterador del mapa ` it ` y devuelve un puntero al siguiente elemento, tras la eliminación.
Véase también remove(), begin(), end(), insert() y extract().
QCborMap::iterator QCborMap::erase(QCborMap::iterator it)
Elimina el par clave-valor al que apunta el iterador del mapa it y devuelve un puntero al siguiente elemento, tras la eliminación.
Esta es una función sobrecargada.
Véanse también remove(), begin(), end() y insert().
QCborValue QCborMap::extract(QCborMap::const_iterator it)
QCborValue QCborMap::extract(QCborMap::iterator it)
Extrae un valor del mapa en la posición indicada por el iterador it y devuelve el valor extraído.
Véase también insert(), erase(), take() y remove().
QCborMap::iterator QCborMap::find(qint64 key)
QCborMap::const_iterator QCborMap::find(qint64 key) const
Devuelve un iterador del mapa para el par clave-valor cuya clave es key, si el mapa contiene dicho par. Si no es así, esta función devuelve end().
CBOR recomienda utilizar claves enteras, ya que ocupan menos espacio y son más sencillas de codificar y decodificar.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(qint64), operator[](qint64), constFind(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &) y value(const QCborValue &).
QCborMap::iterator QCborMap::find(QLatin1StringView key)
QCborMap::const_iterator QCborMap::find(QLatin1StringView key) const
Devuelve un iterador del mapa que apunta al par clave-valor cuya clave es « key », si el mapa contiene dicho par. Si no lo contiene, esta función devuelve « end()».
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(QLatin1StringView), operator[](QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &) y value(const QCborValue &).
QCborMap::iterator QCborMap::find(const QCborValue &key)
QCborMap::const_iterator QCborMap::find(const QCborValue &key) const
Devuelve un iterador del mapa que apunta al par clave-valor cuya clave es key, si el mapa contiene dicho par. Si no lo contiene, esta función devuelve end().
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicativo de un problema en el remitente.
Véase también value(const QCborValue &), operator[](const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView) y value(const QString &).
QCborMap::iterator QCborMap::find(const QString &key)
QCborMap::const_iterator QCborMap::find(const QString &key) const
Devuelve un iterador del mapa que apunta al par clave-valor cuya clave es « key », si el mapa contiene dicho par. Si no lo contiene, esta función devuelve « end()».
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas encontrará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(const QString &), operator[](const QString &), constFind(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView) y value(const QCborValue &).
[static] QCborMap QCborMap::fromJsonObject(const QJsonObject &obj)
Convierte todos los elementos JSON que se encuentran en el objeto ` obj ` a CBOR mediante `QCborValue::fromJson()` y devuelve el mapa compuesto por dichos elementos.
Esta conversión no conlleva pérdida de información, ya que el sistema de tipos de CBOR es un superconjunto del de JSON. Además, el mapa devuelto por esta función puede volver a convertirse al obj original utilizando toJsonObject().
Véanse también toJsonObject(), toVariantMap(), QCborValue::fromJsonValue() y QCborArray::fromJsonArray().
[static noexcept, since 6.3] QCborMap QCborMap::fromJsonObject(QJsonObject &&obj)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.3.
[static] QCborMap QCborMap::fromVariantHash(const QVariantHash &hash)
Convierte todos los elementos de hash a CBOR utilizando QCborValue::fromVariant() y devuelve el mapa compuesto por dichos elementos.
La conversión desde QVariant no es totalmente libre de pérdidas. Consulta la documentación en QCborValue::fromVariant() para obtener más información.
Véanse también toVariantHash(), fromVariantMap(), fromJsonObject() y QCborValue::fromVariant().
[static] QCborMap QCborMap::fromVariantMap(const QVariantMap &map)
Convierte todos los elementos de map a CBOR utilizando QCborValue::fromVariant() y devuelve el mapa compuesto por dichos elementos.
La conversión desde QVariant no es totalmente libre de pérdidas. Consulta la documentación en QCborValue::fromVariant() para obtener más información.
Véanse también toVariantMap(), fromVariantHash(), fromJsonObject() y QCborValue::fromVariant().
QCborMap::iterator QCborMap::insert(QCborMap::value_type v)
Inserta el par clave-valor de v en este mapa y devuelve un iterador de mapa que apunta al par recién insertado.
Si el mapa ya tenía una clave igual a v.first, su valor se sobrescribirá con v.second.
Esta es una función sobrecargada.
Véanse también operator[], erase() y extract().
QCborMap::iterator QCborMap::insert(QLatin1StringView key, const QCborValue &value)
Inserta la clave « key » y el valor « value » en este mapa y devuelve un iterador de mapa que apunta al par recién insertado.
Si el mapa ya tenía una clave igual a key, su valor se sobrescribirá con value.
Esta es una función sobrecargada.
Véase también erase(), remove(QLatin1StringView), value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(QLatin1StringView) y extract().
QCborMap::iterator QCborMap::insert(const QCborValue &key, const QCborValue &value)
Inserta la clave « key » y el valor « value » en este mapa y devuelve un iterador de mapa que apunta al par recién insertado.
Si el mapa ya tenía una clave igual a key, su valor se sobrescribirá con value.
Esta es una función sobrecargada.
Véase también erase(), remove(const QCborValue &), value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(const QCborValue &) y extract().
QCborMap::iterator QCborMap::insert(const QString &key, const QCborValue &value)
Inserta la clave « key » y el valor « value » en este mapa y devuelve un iterador de mapa que apunta al par recién insertado.
Si el mapa ya tenía una clave igual a key, su valor se sobrescribirá con value.
Esta es una función sobrecargada.
Véase también erase(), remove(const QString &), value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(const QString &) y extract().
QCborMap::iterator QCborMap::insert(qint64 key, const QCborValue &value)
Inserta la clave « key » y el valor « value » en este mapa y devuelve un iterador de mapa que apunta al par recién insertado.
Si el mapa ya tenía una clave igual a key, su valor se sobrescribirá con value.
Esta es una función sobrecargada.
Véase también erase(), remove(qint64), value(qint64), operator[](qint64), find(qint64), contains(qint64), take(qint64) y extract().
bool QCborMap::isEmpty() const
Devuelve «true» si este mapa está vacío (es decir, si size() es 0).
Véanse también size() y clear().
[since 6.10] QCborMap::key_value_iterator QCborMap::keyValueBegin()
Devuelve un iterador de estilo STL que apunta a la primera entrada del mapa.
Esta función se introdujo en Qt 6.10.
Véase también ` keyValueEnd()`.
[since 6.10] QCborMap::const_key_value_iterator QCborMap::keyValueBegin() const
Devuelve un iterador const al estilo STL que apunta a la primera entrada del mapa.
Esta función se introdujo en Qt 6.10.
Véase también ` keyValueEnd()`.
[since 6.10] QCborMap::key_value_iterator QCborMap::keyValueEnd()
Devuelve un iterador de estilo STL que apunta a la entrada imaginaria situada después de la última entrada del mapa.
Esta función se introdujo en Qt 6.10.
Véase también ` keyValueBegin()`.
[since 6.10] QCborMap::const_key_value_iterator QCborMap::keyValueEnd() const
Devuelve un iterador const al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del mapa.
Esta función se introdujo en Qt 6.10.
Véase también ` keyValueBegin()`.
QList<QCborValue> QCborMap::keys() const
Devuelve una lista con todas las claves de este mapa.
Véase también QMap::keys() y QHash::keys().
void QCborMap::remove(const QCborValue &key)
Elimina la clave « key » y el valor correspondiente del mapa, si se encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
remove(qint64), remove(QLatin1StringView), remove(const QString &)
Véase también value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &) y contains(const QCborValue &).
void QCborMap::remove(qint64 key)
Elimina la clave « key » y el valor correspondiente del mapa, si se encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele indicar un problema en el remitente.
remove(QLatin1StringView), remove(const QString &), remove(const QCborValue &)
Véase también value(qint64), operator[](qint64), find(qint64) y contains(qint64).
void QCborMap::remove(QLatin1StringView key)
Elimina la clave « key » y el valor correspondiente del mapa, si se encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(qint64), remove(const QString &) y remove(const QCborValue &).
void QCborMap::remove(const QString &key)
Elimina la clave « key » y el valor correspondiente del mapa, si se encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
remove(qint64), remove(QLatin1StringView), remove(const QCborValue &)
Esta es una función sobrecargada.
Véase también value(const QString &), operator[](const QString &), find(const QString &) y contains(const QString &).
[noexcept] qsizetype QCborMap::size() const
Devuelve el número de elementos de este mapa.
Véase también isEmpty().
[noexcept] void QCborMap::swap(QCborMap &other)
Intercambia este mapa por other. Esta operación es muy rápida y nunca falla.
QCborValue QCborMap::take(QLatin1StringView key)
Elimina la clave « key » y el valor correspondiente del mapa y devuelve el valor, si lo encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(qint64), take(const QString &), take(const QCborValue &) y insert().
QCborValue QCborMap::take(const QCborValue &key)
Elimina la clave « key » y el valor correspondiente del mapa y devuelve el valor, si lo encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(QLatin1StringView), take(const QString &), take(qint64) y insert().
QCborValue QCborMap::take(const QString &key)
Elimina la clave « key » y el valor correspondiente del mapa y devuelve el valor, si se encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas eliminará esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicativo de un problema en el remitente.
Véase también value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(QLatin1StringView), take(qint64), take(const QCborValue &) y insert().
QCborValue QCborMap::take(qint64 key)
Elimina la clave « key » y el valor correspondiente del mapa y devuelve el valor, si se encuentra. Si el mapa no contiene dicha clave, esta función no realiza ninguna acción.
Si el mapa contiene más de una clave igual a « key », no está definido cuál de ellas eliminará esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(qint64), operator[](qint64), find(qint64), contains(qint64), take(QLatin1StringView), take(const QString &), take(const QCborValue &) y insert().
QCborValue QCborMap::toCborValue() const
Crea explícitamente un objeto ` QCborValue ` que representa este mapa. Por lo general, esta función no es necesaria, ya que ` QCborValue ` dispone de un constructor para ` QCborMap`, por lo que la conversión es implícita.
La conversión de ` QCborMap ` a ` QCborValue ` permite utilizarlo en cualquier contexto en el que se pueda emplear `QCborValues`, incluyendo como claves y tipos mapeados en ` QCborMap`, así como en ` QCborValue::toCbor()`.
Véase también QCborValue::QCborValue(const QCborMap &).
QJsonObject QCborMap::toJsonObject() const
Convierte de forma recursiva cada valor « QCborValue » de este mapa a JSON utilizando « QCborValue::toJsonValue()» y crea una clave de tipo cadena para todas las claves que no sean cadenas; a continuación, devuelve el « QJsonObject » correspondiente, compuesto por esas asociaciones.
Ten en cuenta que CBOR contiene un conjunto de tipos más amplio y variado que JSON, por lo que puede perderse cierta información en esta conversión. Para obtener más detalles sobre las conversiones que se aplican, consulta QCborValue::toJsonValue().
Conversión de claves de mapa a cadena
Los objetos JSON se definen con claves de tipo cadena, a diferencia de CBOR, por lo que la conversión de un ` QCborMap ` a ` QJsonObject ` implicará un paso de «conversión a cadena» de los valores de las claves. La conversión utilizará el tratamiento especial de las etiquetas y los tipos extendidos mencionado anteriormente y también convertirá el resto de los tipos de la siguiente manera:
| Tipo | Transformación |
|---|---|
| Bool | «true» y «false» |
| Nulo | «nulo» |
| Indefinido | «indefinido» |
| Entero | La representación decimal del número |
| Doble | La representación como cadena decimal del número |
| Matriz de bytes | A menos que se indique lo contrario (véase más arriba), se codifica como Base64url |
| Matriz | Se sustituye por la forma compacta de su Diagnostic notation |
| Mapa | Se sustituye por la forma compacta de su Diagnostic notation |
| Etiquetas y tipos extendidos | Se omite el número de etiqueta y el valor etiquetado se convierte en cadena |
Véase también fromJsonObject(), QCborValue::toJsonValue(), QCborArray::toJsonArray() y toVariantMap().
QVariantHash QCborMap::toVariantHash() const
Convierte los valores CBOR a « QVariant » utilizando ` QCborValue::toVariant()` y «convierte a cadena» todas las claves CBOR de este mapa, devolviendo el objeto ` QVariantHash ` resultante de dicha lista de asociación.
Los QVariantMaps tienen claves de tipo cadena, a diferencia de CBOR, por lo que la conversión de una QCborMap a QVariantMap implicará un paso de «conversión a cadena» de los valores de las claves. Consulte QCborMap::toJsonObject() para obtener más detalles.
Además, la conversión a QVariant no es totalmente sin pérdidas. Consulte la documentación en QCborValue::toVariant() para obtener más información.
Véanse también fromVariantHash(), toVariantMap(), toJsonObject(), QCborValue::toVariant() y QCborArray::toVariantList().
QVariantMap QCborMap::toVariantMap() const
Convierte los valores CBOR a « QVariant » utilizando QCborValue::toVariant() y «convierte a cadena» todas las claves CBOR de este mapa, devolviendo el objeto QVariantMap resultante de esa lista de asociaciones.
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.
Además, la conversión a QVariant no es totalmente libre de pérdidas. Consulte la documentación en QCborValue::toVariant() para obtener más información.
Véanse también fromVariantMap(), toVariantHash(), toJsonObject(), QCborValue::toVariant() y QCborArray::toVariantList().
QCborValue QCborMap::value(const QCborValue &key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estaba presente y el caso en que la clave se asignó a un valor indefinido.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas devolverá esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
value(qint64), value(QLatin1StringView), value(const QString &)
Véase también operator[](const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &) y contains(const QCborValue &).
QCborValue QCborMap::value(qint64 key) const
Devuelve el elemento « QCborValue » de este mapa que se corresponde con la clave « key », si existe. CBOR recomienda utilizar claves enteras, ya que ocupan menos espacio y son más sencillas de codificar y descodificar.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en el que la clave no estaba presente y el caso en el que la clave se asignó a un valor indefinido.
Si el mapa contiene más de una clave igual a « key », no está definido a cuál de ellas hará referencia el valor devuelto por la función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
value(QLatin1StringView), value(const QString &), value(const QCborValue &)
Véase también operator[](qint64), find(qint64), constFind(qint64), remove(qint64) y contains(qint64).
QCborValue QCborMap::value(QLatin1StringView key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe.
Si el mapa no contiene la clave key, esta función devuelve un QCborValue que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en el que la clave no estaba presente y el caso en el que la clave se asignó a un valor indefinido.
Si el mapa contiene más de una clave igual a « key », no está definido cuál devolverá esta función. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
value(qint64), value(const QString &), value(const QCborValue &)
Se trata de una función sobrecargada.
Véase también ` operator[]` (QLatin1StringView), ` find` (QLatin1StringView), ` constFind` (QLatin1StringView), ` remove` (QLatin1StringView) y ` contains` (QLatin1StringView).
QCborValue QCborMap::value(const QString &key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estaba presente y el caso en que la clave se asignaba a un valor indefinido.
Si el mapa contiene más de una clave igual a ` key`, no está definido cuál de ellas devolverá esta función. ` QCborMap ` no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
value(qint64), value(QLatin1StringView), value(const QCborValue &)
Esta es una función sobrecargada.
Véase también operator[](const QString &), find(const QString &), constFind(const QString &), remove(const QString &) y contains(const QString &).
[noexcept, since 6.10] QCborMap &QCborMap::operator=(QCborMap &&other)
Operador de asignación por traslado.
El objeto del que se realiza la asignación other pasa a un estado válido, pero no especificado.
Esta función se introdujo en Qt 6.10.
[noexcept] QCborMap &QCborMap::operator=(const QCborMap &other)
Sustituye el contenido de este objeto por una copia de other y, a continuación, devuelve una referencia a este objeto.
QCborValueRef QCborMap::operator[](qint64 key)
Devuelve un objeto `QCborValueRef` que hace referencia al valor de este mapa correspondiente a la clave ` key`. CBOR recomienda utilizar claves enteras, ya que ocupan menos espacio y son más sencillas de codificar y descodificar.
QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si le asignas nuevos valores, este mapa se actualizará con ese nuevo valor.
Si el mapa no tuviera una clave igual a « key », se insertaría una y esta función devolvería una referencia al nuevo valor, que sería un « QCborValue » con un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estuviera presente y el caso en que la clave estuviera asociada a un valor indefinido.
Si el mapa contiene más de una clave igual a ` key`, no está definido a cuál de ellas hará referencia el valor devuelto. ` QCborMap ` no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Véase también value(qint64), find(qint64), contains(qint64), remove(qint64), operator[](QLatin1StringView), operator[](const QString &) y operator[](const QCborValue &).
const QCborValue QCborMap::operator[](const QCborValue &key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en el que la clave no estaba presente y el caso en el que la clave estaba asociada a un valor indefinido.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas devolverá esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
operator[](qint64), operator[](QLatin1StringView), operator[](const QCborOperator[] &)
Véase también value(const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &) y contains(const QCborValue &).
const QCborValue QCborMap::operator[](qint64 key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe. CBOR recomienda utilizar claves enteras, ya que ocupan menos espacio y son más sencillas de codificar y descodificar.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estaba presente y el caso en que la clave se había asignado a un valor indefinido.
Si el mapa contiene más de una clave igual a key, no está definido cuál de ellas devolverá esta función. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
operator[](QLatin1StringView), operator[](const QString &), operator[](const QCborOperator[] &)
Véase también value(qint64), find(qint64), constFind(qint64), remove(qint64) y contains(qint64).
QCborValueRef QCborMap::operator[](QLatin1StringView key)
Devuelve un QCborValueRef con el valor de este mapa que corresponde a la clave « key ».
QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si le asignas nuevos valores, este mapa se actualizará con ese nuevo valor.
Si el mapa no tuviera una clave igual a « key », se insertaría una y esta función devolvería una referencia al nuevo valor, que sería un ` QCborValue ` con un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en el que la clave no estaba presente y el caso en el que la clave se había asignado a un valor indefinido.
Si el mapa contiene más de una clave igual a « key », no se define a cuál de ellas hará referencia el valor devuelto. « QCborMap » no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(QLatin1StringView), operator[](qint64), operator[](const QString &) y operator[](const QCborValue &).
QCborValueRef QCborMap::operator[](const QCborValue &key)
Devuelve un objeto `QCborValueRef` al valor de este mapa que corresponde a la clave ` key`.
QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si se le asignan nuevos valores, este mapa se actualizará con ese nuevo valor.
Si el mapa no tuviera una clave igual a « key », se insertaría una y esta función devolvería una referencia al nuevo valor, que sería un « QCborValue » con un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estuviera presente y el caso en que la clave estuviera asociada a un valor indefinido.
Si el mapa contiene más de una clave igual a key, no está definido a cuál de ellas hará referencia el valor devuelto. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicativo de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(const QCborValue &), find(const QCborValue &), contains(const QCborValue &), remove(const QCborValue &), operator[](qint64), operator[](QLatin1StringView) y operator[](const QString &).
QCborValueRef QCborMap::operator[](const QString &key)
Devuelve un objeto QCborValueRef con el valor de este mapa que corresponde a la clave « key ».
QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si se le asignan nuevos valores, este mapa se actualizará con ese nuevo valor.
Si el mapa no tuviera una clave igual a « key », se insertaría una y esta función devolvería una referencia al nuevo valor, que sería un ` QCborValue ` con un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en el que la clave no estaba presente y el caso en el que la clave se había asignado a un valor indefinido.
Si el mapa contiene más de una clave igual a key, no está definido a cuál de ellas hará referencia el valor devuelto. QCborMap no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo descodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
Esta es una función sobrecargada.
Véase también value(const QString &), find(const QString &), contains(const QString &), remove(const QString &), operator[](qint64), operator[](QLatin1StringView) y operator[](const QCborValue &).
const QCborValue QCborMap::operator[](QLatin1StringView key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estaba presente y el caso en que la clave se asignó a un valor indefinido.
Si el mapa contiene más de una clave igual a ` key`, no está definido cuál de ellas devolverá esta función. ` QCborMap ` no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
operator[](qint64), operator[](const QString &), operator[](const QCborOperator[] &)
Se trata de una función sobrecargada.
Véase también value(QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView) y contains(QLatin1StringView).
const QCborValue QCborMap::operator[](const QString &key) const
Devuelve el elemento ` QCborValue ` de este mapa que se corresponde con la clave ` key`, si existe.
Si el mapa no contiene la clave « key », esta función devuelve un « QCborValue » que contiene un valor indefinido. Por ese motivo, con esta función no es posible distinguir entre el caso en que la clave no estaba presente y el caso en que la clave se asignó a un valor indefinido.
Si el mapa contiene más de una clave igual a ` key`, no está definido cuál de ellas devolverá esta función. ` QCborMap ` no permite insertar claves duplicadas, pero es posible crear un mapa de este tipo decodificando un flujo CBOR que las contenga. Por lo general, no están permitidas y la presencia de claves duplicadas suele ser indicio de un problema en el remitente.
operator[](qint64), operator[](QLatin1StringView), operator[](const QCborOperator[] &)
Se trata de una función sobrecargada.
Véase también value(const QString &), find(const QString &), constFind(const QString &), remove(const QString &) y contains(const QString &).
Elementos no miembros relacionados
[noexcept] bool operator!=(const QCborMap &lhs, const QCborMap &rhs)
Compara los mapas lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si los dos mapas contienen algún elemento diferente o elementos en un orden distinto; en caso contrario, devuelve «false».
Ten en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por orden ascendente del valor de la clave. De hecho, para la representación CBOR canónica se requieren mapas con las claves ordenadas.
Para obtener más información sobre la igualdad CBOR en Qt, véase QCborValue::compare().
Véase también compare(), QCborValue::operator==(), operator==() y operator<().
[noexcept] bool operator<(const QCborMap &lhs, const QCborMap &rhs)
Compara los mapas lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si el mapa lhs debe ordenarse antes que rhs; en caso contrario, devuelve «false».
Ten en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por valor de clave ascendente. De hecho, los mapas con claves en orden son un requisito para la representación CBOR canónica.
Para obtener más información sobre el orden de clasificación de CBOR, consulte QCborValue::compare().
Véase también compare(), QCborValue::operator==(), QCborMap::operator==(), operator==() y operator!=().
[noexcept] bool operator<=(const QCborMap &lhs, const QCborMap &rhs)
Compara los mapas lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si el mapa lhs debería ordenarse antes que rhs o si los dos mapas contienen los mismos elementos en el mismo orden; en caso contrario, devuelve «false».
Tenga en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por valor de clave ascendente. De hecho, los mapas con claves en orden son un requisito para la representación CBOR canónica.
Para obtener más información sobre el orden de clasificación de CBOR, véase QCborValue::compare().
Véase también compare(), QCborValue::operator==(), QCborMap::operator==(), operator==() y operator!=().
[noexcept] bool operator==(const QCborMap &lhs, const QCborMap &rhs)
Compara los mapas lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si los dos mapas contienen los mismos elementos en el mismo orden; en caso contrario, devuelve «false».
Ten en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por orden ascendente del valor de la clave. De hecho, para la representación CBOR canónica se requieren mapas con las claves ordenadas.
Para obtener más información sobre la igualdad CBOR en Qt, véase QCborValue::compare().
Véase también compare(), QCborValue::operator==(), operator!=() y operator<().
[noexcept] bool operator>(const QCborMap &lhs, const QCborMap &rhs)
Compara los mapas lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si el mapa lhs debería ordenarse después de rhs; en caso contrario, devuelve «false».
Ten en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por valor de clave ascendente. De hecho, los mapas con claves ordenadas son un requisito para la representación CBOR canónica.
Para obtener más información sobre el orden de clasificación de CBOR, consulte QCborValue::compare().
Véase también compare(), QCborValue::operator==(), QCborMap::operator==(), operator==() y operator!=().
[noexcept] bool operator>=(const QCborMap &lhs, const QCborMap &rhs)
Compara los mapas lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si el mapa lhs debería ordenarse después de rhs o si los dos mapas contienen los mismos elementos en el mismo orden; en caso contrario, devuelve «false».
Tenga en cuenta que los mapas CBOR no están ordenados, lo que significa que dos mapas que contengan exactamente los mismos pares, pero en un orden diferente, seguirán comparándose de forma distinta. Para evitarlo, se recomienda insertar los elementos en el mapa en un orden predecible, por ejemplo, por valor de clave ascendente. De hecho, para la representación CBOR canónica se requieren mapas con claves en orden.
Para obtener más información sobre el orden de clasificación de CBOR, consulte QCborValue::compare().
Véase 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.