En esta página

QCborArray Class

La clase QCborArray se utiliza para almacenar una matriz de elementos CBOR. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QCborArray

CategoríaTipos comparables
strongQCborArray
strongQCborValueConstRef.

Tipos públicos

Funciones públicas

QCborArray()
QCborArray(std::initializer_list<QCborValue> args)
QCborArray(const QCborArray &other)
(since 6.10) QCborArray(QCborArray &&other)
~QCborArray()
void append(QCborValue &&value)
void append(const QCborValue &value)
QCborValue at(qsizetype i) const
QCborArray::iterator begin()
QCborArray::const_iterator begin() const
QCborArray::const_iterator cbegin() const
QCborArray::const_iterator cend() const
void clear()
int compare(const QCborArray &other) const
QCborArray::const_iterator constBegin() const
QCborArray::const_iterator constEnd() const
bool contains(const QCborValue &value) const
bool empty() const
QCborArray::iterator end()
QCborArray::const_iterator end() const
QCborArray::iterator erase(QCborArray::const_iterator it)
QCborArray::iterator erase(QCborArray::iterator it)
QCborValue extract(QCborArray::ConstIterator it)
QCborValue extract(QCborArray::Iterator it)
QCborValueRef first()
QCborValue first() const
void insert(qsizetype i, QCborValue &&value)
void insert(qsizetype i, const QCborValue &value)
QCborArray::iterator insert(QCborArray::const_iterator before, const QCborValue &value)
QCborArray::iterator insert(QCborArray::iterator before, const QCborValue &value)
bool isEmpty() const
QCborValueRef last()
QCborValue last() const
void pop_back()
void pop_front()
void prepend(QCborValue &&value)
void prepend(const QCborValue &value)
void push_back(const QCborValue &t)
void push_front(const QCborValue &t)
void removeAt(qsizetype i)
void removeFirst()
void removeLast()
qsizetype size() const
void swap(QCborArray &other)
QCborValue takeAt(qsizetype i)
QCborValue takeFirst()
QCborValue takeLast()
QCborValue toCborValue() const
QJsonArray toJsonArray() const
QVariantList toVariantList() const
QCborArray operator+(const QCborValue &v) const
QCborArray &operator+=(const QCborValue &v)
QCborArray &operator<<(const QCborValue &v)
(since 6.10) QCborArray &operator=(QCborArray &&other)
QCborArray &operator=(const QCborArray &other)
QCborValueRef operator[](qsizetype i)
const QCborValue operator[](qsizetype i) const

Miembros públicos estáticos

QCborArray fromJsonArray(const QJsonArray &array)
(since 6.3) QCborArray fromJsonArray(QJsonArray &&array)
QCborArray fromStringList(const QStringList &list)
QCborArray fromVariantList(const QVariantList &list)
bool operator!=(const QCborArray &lhs, const QCborArray &rhs)
bool operator<(const QCborArray &lhs, const QCborArray &rhs)
bool operator<=(const QCborArray &lhs, const QCborArray &rhs)
bool operator==(const QCborArray &lhs, const QCborArray &rhs)
bool operator>(const QCborArray &lhs, const QCborArray &rhs)
bool operator>=(const QCborArray &lhs, const QCborArray &rhs)

Descripción detallada

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

QCborArray es muy similar a QVariantList y QJsonArray, y su API es casi idéntica a la de esas dos clases. También se puede convertir a y desde esas dos clases, aunque puede producirse una pérdida de información en algunas conversiones.

Véase también QCborValue, QCborMap, QJsonArray, QList, «Análisis y visualización de datos CBOR», «Convertidor de serialización» y «Guardar y cargar una partida».

Documentación sobre los tipos de miembro

QCborArray::const_iterator

Sinónimo de « QCborArray::ConstIterator ».

QCborArray::const_pointer

Un `typedef` para ` const QCborValue *`, con el fin de garantizar la compatibilidad con algoritmos genéricos.

QCborArray::const_reference

Un `typedef` para ` const QCborValue &`, para garantizar la compatibilidad con algoritmos genéricos.

QCborArray::difference_type

Un `typedef` para `qsizetype`.

QCborArray::iterator

Sinónimo de « QCborArray::Iterator ».

QCborArray::pointer

Un `typedef` para ` QCborValue *`, para garantizar la compatibilidad con algoritmos genéricos.

QCborArray::reference

Un `typedef` para ` QCborValue &`, para garantizar la compatibilidad con algoritmos genéricos.

QCborArray::size_type

Un `typedef` para `qsizetype`.

QCborArray::value_type

El tipo de valores que puede contener un ` QCborArray`: es decir, ` QCborValue`.

Documentación de las funciones de miembro

[noexcept] QCborArray::QCborArray()

Crea un objeto QCborArray vacío.

QCborArray::QCborArray(std::initializer_list<QCborValue> args)

Inicializa este QCborArray a partir de la lista entre llaves de C++ que se encuentra en args, tal y como se muestra en el siguiente ejemplo:

QCborArray a = { null, 0, 1, 1.5, 2, "Hello", QByteArray("World") };

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

Copia el contenido de « other » en este objeto.

[constexpr noexcept default, since 6.10] QCborArray::QCborArray(QCborArray &&other)

Constructor de traslado.

El objeto del que se ha realizado la movida other se coloca en el estado de construcción por defecto.

Esta función se introdujo en Qt 6.10.

Véase también QCborArray::QCborArray().

[noexcept] QCborArray::~QCborArray()

Elimina este objeto ` QCborArray ` y libera los recursos asociados.

void QCborArray::append(QCborValue &&value)

void QCborArray::append(const QCborValue &value)

Añade value a la matriz después de todos los demás elementos que esta pueda contener ya.

Véase también at(), operator[](), first(), last(), insert(), prepend(), removeAt() y takeAt().

QCborValue QCborArray::at(qsizetype i) const

Devuelve el elemento QCborValue situado en la posición i del array.

Si el array tiene menos de i elementos, 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 el array no es lo suficientemente grande y el caso en el que el array comienza con un valor indefinido.

Véase también operator[](), first(), last(), insert(), prepend(), append(), removeAt() y takeAt().

QCborArray::iterator QCborArray::begin()

Devuelve un iterador de matriz que apunta al primer elemento de esta matriz. Si la matriz está vacía, esta función devuelve lo mismo que end().

Véanse también constBegin() y end().

QCborArray::const_iterator QCborArray::begin() const

Devuelve un iterador de matriz que apunta al primer elemento de esta matriz. Si la matriz está vacía, esta función devuelve lo mismo que end().

Véase también constBegin() y constEnd().

QCborArray::const_iterator QCborArray::cbegin() const

Devuelve un iterador de matriz que apunta al primer elemento de esta matriz. Si la matriz está vacía, esta función devuelve lo mismo que end().

Véase también constBegin() y constEnd().

QCborArray::const_iterator QCborArray::cend() const

Devuelve un iterador de matriz que apunta justo después del último elemento de esta matriz.

Véase también constBegin() y constEnd().

void QCborArray::clear()

Vacía este array.

Véase también isEmpty().

[noexcept] int QCborArray::compare(const QCborArray &other) const

Compara este matriz con other, comparando cada elemento por orden, y devuelve un entero que indica si este matriz 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 matrices son iguales y contienen los mismos elementos.

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

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

QCborArray::const_iterator QCborArray::constBegin() const

Devuelve un iterador de matriz que apunta al primer elemento de esta matriz. Si la matriz está vacía, esta función devuelve lo mismo que end().

Véase también begin() y constEnd().

QCborArray::const_iterator QCborArray::constEnd() const

Devuelve un iterador de matriz que apunta justo después del último elemento de esta matriz.

Véase también constBegin() y end().

bool QCborArray::contains(const QCborValue &value) const

Devuelve «true» si este array contiene un elemento que sea igual a value.

bool QCborArray::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 array está vacío (size() == 0).

Véanse también isEmpty() y size().

QCborArray::iterator QCborArray::end()

Devuelve un iterador de matriz que apunta justo después del último elemento de esta matriz.

Véase también begin() y constEnd().

QCborArray::const_iterator QCborArray::end() const

Devuelve un iterador de matriz que apunta justo después del último elemento de esta matriz.

Véase también constBegin() y constEnd().

Elimina de este array el elemento al que apunta el iterador del array it y, a continuación, devuelve un iterador al siguiente elemento (el que ocupa ahora la misma posición en el array que antes ocupaba it ).

Véase también insert(), removeAt(), takeAt(), takeFirst() y takeLast().

QCborValue QCborArray::extract(QCborArray::ConstIterator it)

QCborValue QCborArray::extract(QCborArray::Iterator it)

Extrae un valor del array en la posición indicada por el iterador it y devuelve el valor extraído.

Véase también insert(), erase(), takeAt() y removeAt().

QCborValueRef QCborArray::first()

Devuelve una referencia al primer QCborValue de este array. El array no debe estar vacío.

QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si se le asignan nuevos valores, este array se actualizará con ese nuevo valor.

Véase también operator[](), at(), last(), insert(), prepend(), append(), removeAt() y takeAt().

QCborValue QCborArray::first() const

Devuelve el primer ` QCborValue ` de este array.

Si el array está vacío, 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 el array no es lo suficientemente grande y el caso en el que el array termina con un valor indefinido.

Véase también operator[](), at(), last(), insert(), prepend(), append(), removeAt() y takeAt().

[static] QCborArray QCborArray::fromJsonArray(const QJsonArray &array)

Convierte todos los elementos JSON que se encuentran en la matriz ` array ` a CBOR mediante `QCborValue::fromJson()` y devuelve la matriz CBOR compuesta 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 array devuelto por esta función puede volver a convertirse al array original utilizando toJsonArray().

Véanse también toJsonArray(), toVariantList(), QCborValue::fromJsonValue() y QCborMap::fromJsonObject().

[static noexcept, since 6.3] QCborArray QCborArray::fromJsonArray(QJsonArray &&array)

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.3.

[static] QCborArray QCborArray::fromStringList(const QStringList &list)

Devuelve un objeto ` QCborArray ` que contiene todas las cadenas encontradas en la lista ` list `.

Véase también fromVariantList() y fromJsonArray().

[static] QCborArray QCborArray::fromVariantList(const QVariantList &list)

Convierte todos los elementos del objeto ` list ` a CBOR mediante ` QCborValue::fromVariant()` y devuelve la matriz compuesta por dichos elementos.

La conversión desde QVariant no es totalmente libre de pérdidas. Consulte la documentación de QCborValue::fromVariant() para obtener más información.

Véanse también toVariantList(), fromStringList(), fromJsonArray() y QCborMap::fromVariantMap().

void QCborArray::insert(qsizetype i, QCborValue &&value)

void QCborArray::insert(qsizetype i, const QCborValue &value)

Inserta value en la posición i de este array. Si i es -1, la entrada se añade al final del array. Rellena el array con entradas no válidas si i es mayor que el tamaño anterior del array.

Véase también at(), operator[](), first(), last(), prepend(), append(), removeAt(), takeAt() y extract().

QCborArray::iterator QCborArray::insert(QCborArray::const_iterator before, const QCborValue &value)

QCborArray::iterator QCborArray::insert(QCborArray::iterator before, const QCborValue &value)

Inserta value en este array antes del elemento before y devuelve un iterador de array que apunta al elemento que acaba de insertarse.

Véase también erase(), removeAt(), prepend() y append().

bool QCborArray::isEmpty() const

Devuelve «true» si este « QCborArray » está vacío (es decir, si « size()» es 0).

Véase también size() y clear().

QCborValueRef QCborArray::last()

Devuelve una referencia al último elemento de este array ( QCborValue ). El array no debe estar vacío.

QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si se le asignan nuevos valores, este array se actualizará con ese nuevo valor.

Véase también operator[](), at(), first(), insert(), prepend(), append(), removeAt() y takeAt().

QCborValue QCborArray::last() const

Devuelve el último objeto ` QCborValue ` de este array.

Si el array está vacío, 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 el array no es lo suficientemente grande y aquel en el que el array termina con un valor indefinido.

Véanse también operator[](), at(), first(), insert(), prepend(), append(), removeAt() y takeAt().

void QCborArray::pop_back()

Sinónimo de removeLast(). Esta función se proporciona para garantizar la compatibilidad con el código genérico que utiliza la API de la biblioteca estándar.

Elimina el último elemento de este array. El array no debe estar vacío antes de la eliminación

Véase también removeLast(), takeLast(), pop_front(), push_back(), append() y insert().

void QCborArray::pop_front()

Sinónimo de ` removeFirst()`. Esta función se proporciona para garantizar la compatibilidad con el código genérico que utiliza la API de la biblioteca estándar.

Elimina el primer elemento de esta matriz. La matriz no debe estar vacía antes de la eliminación

Véase también removeFirst(), takeFirst(), pop_back(), push_front(), prepend() y insert().

void QCborArray::prepend(QCborValue &&value)

void QCborArray::prepend(const QCborValue &value)

Añade « value » al principio de la matriz, antes de cualquier otro elemento que ya pueda contener.

Véanse también at(), operator[](), first(), last(), insert(), append(), removeAt() y takeAt().

void QCborArray::push_back(const QCborValue &t)

Sinónimo de append(). Esta función se proporciona para garantizar la compatibilidad con el código genérico que utiliza la API de la biblioteca estándar.

Añade el elemento t a este array.

Véanse también append(), push_front(), pop_back(), prepend() y insert().

void QCborArray::push_front(const QCborValue &t)

Sinónimo de ` prepend()`. Esta función se proporciona para garantizar la compatibilidad con el código genérico que utiliza la API de la biblioteca estándar.

Añade el elemento t al principio de este array.

Véase también prepend(), push_back(), pop_front(), append() y insert().

void QCborArray::removeAt(qsizetype i)

Elimina el elemento situado en la posición i de la matriz. La matriz debe tener más de i elementos antes de la eliminación.

Véase también takeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() y append().

void QCborArray::removeFirst()

Elimina el primer elemento del array, con lo que el segundo elemento pasa a ser el primero. El array no debe estar vacío antes de esta llamada.

Véase también removeAt(), takeFirst(), removeLast(), at(), operator[](), insert(), prepend() y append().

void QCborArray::removeLast()

Elimina el último elemento del array. El array no debe estar vacío antes de esta llamada.

Véase también removeAt(), takeLast(), removeFirst(), at(), operator[](), insert(), prepend() y append().

[noexcept] qsizetype QCborArray::size() const

Devuelve el tamaño de este array.

Véase también isEmpty().

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

Intercambia los elementos de este array con los de other. Esta operación es muy rápida y nunca falla.

QCborValue QCborArray::takeAt(qsizetype i)

Elimina el elemento situado en la posición i de la matriz y lo devuelve. La matriz debe tener más de i elementos antes de la eliminación.

Véase también removeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() y append().

QCborValue QCborArray::takeFirst()

Elimina el primer elemento del array y lo devuelve, con lo que el segundo elemento pasa a ser el primero. El array no debe estar vacío antes de esta llamada.

Véase también takeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() y append().

QCborValue QCborArray::takeLast()

Elimina el último elemento del array y lo devuelve. El array no debe estar vacío antes de esta llamada.

Véase también takeAt(), removeLast(), removeFirst(), at(), operator[](), insert(), prepend() y append().

QCborValue QCborArray::toCborValue() const

Crea explícitamente un objeto ` QCborValue ` que representa este array. Por lo general, esta función no es necesaria, ya que ` QCborValue ` dispone de un constructor para ` QCborArray`, por lo que la conversión es implícita.

La conversión de ` QCborArray ` a ` QCborValue ` permite utilizarlo en cualquier contexto en el que se pueda usar `QCborValues`, incluyendo como elementos en `QCborArrays` y como claves y tipos mapeados en ` QCborMap`. La conversión de un array a ` QCborValue ` permite acceder a ` QCborValue::toCbor()`.

Véase también QCborValue::QCborValue(const QCborArray &).

QJsonArray QCborArray::toJsonArray() const

Convierte de forma recursiva cada elemento « QCborValue » de este array a JSON utilizando QCborValue::toJsonValue() y devuelve el QJsonArray correspondiente compuesto por dichos elementos.

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().

Véanse también fromJsonArray(), QCborValue::toJsonValue(), QCborMap::toJsonObject() y toVariantList().

QVariantList QCborArray::toVariantList() const

Convierte de forma recursiva cada elemento de tipo « QCborValue » de este array utilizando « QCborValue::toVariant()» y devuelve el « QVariantList » compuesto por los elementos convertidos.

La conversión a QVariant no es totalmente sin pérdidas. Consulte la documentación de QCborValue::toVariant() para obtener más información.

Véanse también fromVariantList(), fromStringList(), toJsonArray(), QCborValue::toVariant() y QCborMap::toVariantMap().

QCborArray QCborArray::operator+(const QCborValue &v) const

Devuelve un nuevo ` QCborArray ` que contiene los mismos elementos que este array, además de ` v ` añadido como último elemento.

Véase también operator+=(), operator<<() y append().

QCborArray &QCborArray::operator+=(const QCborValue &v)

Añade v a este array y devuelve una referencia a este array.

Véase también append(), insert(), operator+() y operator<<().

QCborArray &QCborArray::operator<<(const QCborValue &v)

Añade v a este array y devuelve una referencia a este array.

Véase también append(), insert(), operator+() y operator+=().

[noexcept, since 6.10] QCborArray &QCborArray::operator=(QCborArray &&other)

Operador de asignación por traslado.

El objeto del que se realiza la asignación other pasa a un estado válido, aunque no especificado.

Esta función se introdujo en Qt 6.10.

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

Sustituye el contenido de este array por el que se encuentra en other y, a continuación, devuelve una referencia a este objeto.

QCborValueRef QCborArray::operator[](qsizetype i)

Devuelve una referencia al elemento QCborValue situado en la posición i del array. Los índices que superen el final del array harán que este se amplíe, rellenándose con entradas indefinidas, hasta que haya una entrada en el índice especificado.

QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si se le asignan nuevos valores, este array se actualizará con ese nuevo valor.

Véase también at(), first(), last(), insert(), prepend(), append(), removeAt() y takeAt().

const QCborValue QCborArray::operator[](qsizetype i) const

Devuelve el elemento QCborValue situado en la posición i del array.

Si el array tiene menos de i elementos, 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 el array no es lo suficientemente grande y aquel en que el array contiene un valor indefinido en la posición i.

Véase también at(), first(), last(), insert(), prepend(), append(), removeAt() y takeAt().

Relacionado: No miembros

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

Compara los matrices lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si el contenido de las dos matrices es diferente; en caso contrario, devuelve «false».

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

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

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

Compara las matrices « lhs » y « rhs », comparando cada elemento de forma secuencial, y devuelve «true» si la matriz « lhs » debe ordenarse antes que « rhs », y «false» en caso contrario.

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

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

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

Compara las matrices lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si la matriz lhs debe ordenarse antes que rhs, o «false» en caso contrario, es decir, si ambas matrices contienen los mismos elementos.

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

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

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

Compara los matrices lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si ambas matrices contienen los mismos elementos; en caso contrario, devuelve «false».

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

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

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

Compara las matrices lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si la matriz lhs debe ordenarse después de rhs; en caso contrario, devuelve «false».

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

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

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

Compara las matrices lhs y rhs, comparando cada elemento de forma secuencial, y devuelve «true» si la matriz lhs debería ordenarse después de rhs, o si ambas matrices contienen los mismos elementos; en caso contrario, devuelve «false».

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

Véanse también compare(), QCborValue::operator==(), QCborMap::operator==(), 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.