QCborArray Class

Documentación de las funciones miembro

[noexcept] QCborArray::QCborArray()

Construye un QCborArray vacío.

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

Inicializa este QCborArray a partir de la lista con corchetes de C++ que se encuentra en args, como 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, since 6.10] QCborArray::QCborArray(QCborArray &&other)

Mover-constructor.

El objeto movido other se coloca en el estado construido por defecto.

Esta función se introdujo en Qt 6.10.

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

[noexcept] QCborArray::~QCborArray()

Destruye este QCborArray y libera los recursos asociados.

Añade value al array después de todos los demás elementos que ya contenga.

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

QCborValue QCborArray::at(qsizetype i) const

Devuelve el elemento QCborValue en la posición i de la matriz.

Si la matriz tiene menos de i elementos, esta función devuelve un QCborValue que contiene un valor indefinido. Por este motivo, con esta función no es posible distinguir la situación en la que el array no es lo suficientemente grande del 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éase 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 esta matriz y other, comparando cada elemento en secuencia, y devuelve un entero que indica si esta 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, las dos matrices son iguales y contienen los mismos elementos.

Para más información sobre el orden CBOR, véase 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 array que apunta justo después del último elemento de este array.

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

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

Devuelve true si esta matriz contiene un elemento que es igual a value.

bool QCborArray::empty() const

Sinónimo de isEmpty(). Esta función se proporciona por 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éase 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 esta matriz el elemento apuntado por el iterador de matriz it, y luego devuelve un iterador al siguiente elemento (el que ocupaba la misma posición en la matriz que ocupaba it ).

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

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

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

QCborValueRef QCborArray::first()

Devuelve una referencia a la primera QCborValue de esta matriz. El array no debe estar vacío.

QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si le asignas 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 esta matriz.

Si la matriz está vacía, esta función devuelve un QCborValue que contiene un valor indefinido. Por esta razón, con esta función no es posible distinguir la situación en la que el array no es lo suficientemente grande del 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 encontrados en la matriz array a CBOR utilizando QCborValue::fromJson(), y devuelve la matriz CBOR compuesta por esos elementos.

Esta conversión no tiene pérdidas, ya que el sistema de tipos CBOR es un superconjunto del de JSON. Además, el array devuelto por esta función puede convertirse de nuevo al original array utilizando toJsonArray().

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

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

Esta función se introdujo en Qt 6.3.

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

Devuelve un 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 de list a CBOR utilizando QCborValue::fromVariant() y devuelve el array compuesto por dichos elementos.

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

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

Inserta value en la matriz en la posición i en esta matriz. Si i es -1, la entrada se añade a la matriz. 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().

Inserta value en este array antes del elemento before y devuelve un iterador de array que apunta al elemento recién insertado.

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

bool QCborArray::isEmpty() const

Devuelve verdadero 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 a la última QCborValue de esta matriz. El array no debe estar vacío.

QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si le asignas 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 QCborValue de esta matriz.

Si la matriz está vacía, esta función devuelve un QCborValue que contiene un valor indefinido. Por esta razón, con esta función no es posible distinguir la situación en la que el array no es lo suficientemente grande del caso en el que el array termina con un valor indefinido.

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

void QCborArray::pop_back()

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

Elimina el último elemento de esta matriz. 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 por compatibilidad con el código genérico que utiliza la API de la biblioteca estándar.

Elimina el primer elemento de esta matriz. El array no debe estar vacío antes de la eliminación

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

Antepone value al array antes de cualquier otro elemento que ya contenga.

Véase 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 por 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éase 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 por 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éase también prepend(), push_back(), pop_front(), append(), y insert().

void QCborArray::removeAt(qsizetype i)

Elimina de la matriz el elemento situado en la posición i. El array 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, haciendo que el segundo elemento se convierta en 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 esta matriz con other. Esta operación es muy rápida y nunca falla.

QCborValue QCborArray::takeAt(qsizetype i)

Elimina el elemento en la posición i de la matriz y lo devuelve. El array 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, haciendo que el segundo elemento pase 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

Construye explícitamente un objeto QCborValue que representa este array. Esta función no suele ser necesaria ya que QCborValue tiene un constructor para QCborArray, por lo que la conversión es implícita.

La conversión de QCborArray a QCborValue permite su uso en cualquier contexto en el que se puedan utilizar QCborValues, incluyendo como elementos en QCborArrays y como claves y tipos mapeados en QCborMap. Convertir un array a QCborValue permite acceder a QCborValue::toCbor().

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

QJsonArray QCborArray::toJsonArray() const

Convierte recursivamente cada elemento QCborValue de esta matriz a JSON utilizando QCborValue::toJsonValue() y devuelve el correspondiente QJsonArray compuesto por esos elementos.

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. Para más detalles sobre qué conversiones se aplican, véase QCborValue::toJsonValue().

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

QVariantList QCborArray::toVariantList() const

Convierte recursivamente cada QCborValue de esta matriz utilizando QCborValue::toVariant() y devuelve el QVariantList compuesto por los elementos convertidos.

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

Véase 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, más 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 movimiento-asignación.

El objeto movido other se coloca en un estado válido, pero 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 devuelve una referencia a este objeto.

QCborValueRef QCborArray::operator[](qsizetype i)

Devuelve una referencia al elemento QCborValue en la posición i de la matriz. Los índices más allá del final del array harán crecer el array, llenándolo con entradas indefinidas, hasta que tenga una entrada en el índice especificado.

QCborValueRef tiene exactamente la misma API que QCborValue, con una diferencia importante: si le asignas 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 en la posición i de la matriz.

Si la matriz tiene menos de i elementos, esta función devuelve un QCborValue que contiene un valor indefinido. Por esta razón, con esta función no es posible distinguir la situación en la que el array no es lo suficientemente grande del caso en el 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().