En esta página

QJsonArray Class

La clase QJsonArray encapsula una matriz JSON. Más información...

Encabezado: #include <QJsonArray>
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 QJsonArray

CategoríaTipos comparables
igualdadQJsonArray
igualdadQJsonValue.

Tipos públicos

Funciones públicas

QJsonArray()
QJsonArray(std::initializer_list<QJsonValue> args)
QJsonArray(const QJsonArray &other)
QJsonArray(QJsonArray &&other)
~QJsonArray()
void append(const QJsonValue &value)
QJsonValue at(qsizetype i) const
QJsonArray::iterator begin()
QJsonArray::const_iterator begin() const
QJsonArray::const_iterator cbegin() const
QJsonArray::const_iterator cend() const
QJsonArray::const_iterator constBegin() const
QJsonArray::const_iterator constEnd() const
bool contains(const QJsonValue &value) const
qsizetype count() const
bool empty() const
QJsonArray::iterator end()
QJsonArray::const_iterator end() const
QJsonArray::iterator erase(QJsonArray::iterator it)
QJsonValue first() const
QJsonArray::iterator insert(QJsonArray::iterator before, const QJsonValue &value)
void insert(qsizetype i, const QJsonValue &value)
bool isEmpty() const
QJsonValue last() const
void pop_back()
void pop_front()
void prepend(const QJsonValue &value)
void push_back(const QJsonValue &value)
void push_front(const QJsonValue &value)
void removeAt(qsizetype i)
void removeFirst()
void removeLast()
void replace(qsizetype i, const QJsonValue &value)
qsizetype size() const
void swap(QJsonArray &other)
QJsonValue takeAt(qsizetype i)
QVariantList toVariantList() const
QJsonArray operator+(const QJsonValue &value) const
QJsonArray &operator+=(const QJsonValue &value)
QJsonArray &operator<<(const QJsonValue &value)
QJsonArray &operator=(QJsonArray &&other)
QJsonArray &operator=(const QJsonArray &other)
QJsonValueRef operator[](qsizetype i)
QJsonValue operator[](qsizetype i) const

Miembros públicos estáticos

QJsonArray fromStringList(const QStringList &list)
QJsonArray fromVariantList(const QVariantList &list)
bool operator!=(const QJsonArray &lhs, const QJsonArray &rhs)
bool operator==(const QJsonArray &lhs, const QJsonArray &rhs)

Descripción detallada

Un array JSON es una lista de valores. La lista se puede manipular insertando y eliminando objetos ` QJsonValue` del array.

Un QJsonArray se puede convertir a y desde un objeto de tipo « QVariantList ». Se puede consultar el número de entradas con las funciones « size()», « insert()» y « removeAt()», así como iterar sobre su contenido utilizando el patrón de iterador estándar de C++.

QJsonArray es una clase compartida implícitamente y comparte los datos con el documento a partir del cual se ha creado, siempre y cuando este no se modifique.

Puedes convertir la matriz a y desde JSON basado en texto mediante QJsonDocument.

Véase también Compatibilidad con JSON en Qt y Guardar y cargar una partida.

Documentación sobre los tipos de miembros

QJsonArray::ConstIterator

Sinónimo al estilo Qt de « QJsonArray::const_iterator ».

QJsonArray::Iterator

Sinónimo al estilo Qt de « QJsonArray::iterator ».

QJsonArray::const_pointer

Definición de tipo para `const QJsonValue *`. Se proporciona para garantizar la compatibilidad con la STL.

QJsonArray::const_reference

Definición de tipo para `const QJsonValue &`. Se proporciona para garantizar la compatibilidad con la STL.

QJsonArray::difference_type

Definición de tipo para `qsizetype`. Se proporciona para garantizar la compatibilidad con la STL.

QJsonArray::pointer

Definición de tipo para ` QJsonValue *`. Se proporciona para garantizar la compatibilidad con la STL.

QJsonArray::reference

Definición de tipo para QJsonValue y &. Se proporciona para garantizar la compatibilidad con la STL.

QJsonArray::size_type

Definición de tipo para `qsizetype`. Se proporciona para garantizar la compatibilidad con la STL.

QJsonArray::value_type

Definición de tipo para ` QJsonValue`. Se proporciona para garantizar la compatibilidad con la STL.

Documentación de las funciones miembro

QJsonArray::QJsonArray()

Crea un array vacío.

QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args)

Crea un array inicializado a partir de una lista de inicializacion args.

QJsonArray se puede construir de forma similar a la notación JSON, por ejemplo:

QJsonArray array = { 1, 2.2, QString() };

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

Crea una copia de ` other`.

Dado que QJsonArray se comparte implícitamente, la copia es superficial siempre y cuando el objeto no se modifique.

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

Crea un QJsonArray a partir de other mediante la construcción «move».

[noexcept] QJsonArray::~QJsonArray()

Elimina la matriz.

void QJsonArray::append(const QJsonValue &value)

Inserta « value » al final de la matriz.

Véase también prepend() y insert().

QJsonValue QJsonArray::at(qsizetype i) const

Devuelve un objeto ` QJsonValue ` que representa el valor correspondiente al índice ` i`.

El ` QJsonValue ` devuelto es ` Undefined` si ` i ` está fuera de límites.

QJsonArray::iterator QJsonArray::begin()

Devuelve un iterador de tipo STL que apunta al primer elemento de la matriz.

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

QJsonArray::const_iterator QJsonArray::begin() const

Esta es una función sobrecargada.

QJsonArray::const_iterator QJsonArray::cbegin() const

Devuelve un iterador constante al estilo STL que apunta al primer elemento de la matriz.

Véase también ` begin()` y ` cend()`.

QJsonArray::const_iterator QJsonArray::cend() const

Devuelve un iterador constante al estilo STL que apunta al elemento imaginario situado después del último elemento del array.

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

QJsonArray::const_iterator QJsonArray::constBegin() const

Devuelve un iterador constante al estilo STL que apunta al primer elemento de la matriz.

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

QJsonArray::const_iterator QJsonArray::constEnd() const

Devuelve un iterador constante al estilo STL que apunta al elemento imaginario situado después del último elemento de la matriz.

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

bool QJsonArray::contains(const QJsonValue &value) const

Devuelve « true » si la matriz contiene alguna aparición de « value »; en caso contrario, devuelve « false ».

Véase también count().

qsizetype QJsonArray::count() const

Igual que size().

Véase también size().

bool QJsonArray::empty() const

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a ` isEmpty()` y devuelve ` true ` si la matriz está vacía.

QJsonArray::iterator QJsonArray::end()

Devuelve un iterador de estilo STL que apunta al elemento imaginario situado después del último elemento de la matriz.

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

QJsonArray::const_iterator QJsonArray::end() const

Esta es una función sobrecargada.

QJsonArray::iterator QJsonArray::erase(QJsonArray::iterator it)

Elimina el elemento al que apunta ` it` y devuelve un iterador que apunta al elemento siguiente.

Véase también removeAt().

QJsonValue QJsonArray::first() const

Devuelve el primer valor almacenado en el array.

Es lo mismo que at(0).

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

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

Convierte la lista de cadenas « list » en un « QJsonArray ».

Los valores de list se convertirán a valores JSON.

Véase también toVariantList() y QJsonValue::fromVariant().

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

Convierte la lista de variantes list en un QJsonArray.

Los valores de QVariant en list se convertirán a valores JSON.

Nota: La conversión desde QVariant no es totalmente sin pérdidas. Consulta la documentación en QJsonValue::fromVariant() para obtener más información.

Véase también « toVariantList » () y « QJsonValue::fromVariant » ().

QJsonArray::iterator QJsonArray::insert(QJsonArray::iterator before, const QJsonValue &value)

Inserta un objeto ` value ` antes de la posición a la que apunta ` before` y devuelve un iterador que apunta al elemento recién insertado.

Véase también erase() y insert(qsizetype, const QJsonValue &).

void QJsonArray::insert(qsizetype i, const QJsonValue &value)

Inserta value en la posición de índice i de la matriz. Si i es 0, el valor se añade al principio de la matriz. Si i es size(), el valor se añade al final de la matriz.

Véanse también append(), prepend(), replace() y removeAt().

bool QJsonArray::isEmpty() const

Devuelve ` true ` si el objeto está vacío. Esto equivale a ` size()` == 0.

Véase también size().

QJsonValue QJsonArray::last() const

Devuelve el último valor almacenado en el array.

Es lo mismo que ` at(size() - 1)`.

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

void QJsonArray::pop_back()

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a ` removeLast()`. La matriz no debe estar vacía. Si la matriz puede estar vacía, llama a ` isEmpty()` antes de llamar a esta función.

void QJsonArray::pop_front()

Esta función se proporciona para garantizar la compatibilidad con STL. Es equivalente a ` removeFirst()`. La matriz no debe estar vacía. Si la matriz puede estar vacía, llama a ` isEmpty()` antes de llamar a esta función.

void QJsonArray::prepend(const QJsonValue &value)

Inserta « value » al principio del array.

Esto es lo mismo que insert(0, value) y añadirá value al principio de la matriz.

Véase también append() y insert().

void QJsonArray::push_back(const QJsonValue &value)

Esta función se proporciona para garantizar la compatibilidad con STL. Es equivalente a « append(value)» y añadirá « value » al array.

void QJsonArray::push_front(const QJsonValue &value)

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a « prepend(valor)» y añadirá « value » al principio de la matriz.

void QJsonArray::removeAt(qsizetype i)

Elimina el valor situado en la posición de índice i. i debe ser una posición de índice válida en la matriz (es decir, 0 <= i < size()).

Véase también insert() y replace().

void QJsonArray::removeFirst()

Elimina el primer elemento del array. Llamar a esta función equivale a llamar a removeAt(0). El array no debe estar vacío. Si el array puede estar vacío, llama a isEmpty() antes de llamar a esta función.

Véanse también removeAt() y removeLast().

void QJsonArray::removeLast()

Elimina el último elemento del array. Llamar a esta función equivale a llamar a removeAt(size() - 1). El array no debe estar vacío. Si el array puede estar vacío, llama a isEmpty() antes de llamar a esta función.

Véanse también removeAt() y removeFirst().

void QJsonArray::replace(qsizetype i, const QJsonValue &value)

Sustituye el elemento situado en la posición de índice i por value. i debe ser una posición de índice válida en la matriz (es decir, 0 <= i < size()).

Véase también operator[]() y removeAt().

qsizetype QJsonArray::size() const

Devuelve el número de valores almacenados en la matriz.

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

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

QJsonValue QJsonArray::takeAt(qsizetype i)

Elimina el elemento situado en la posición de índice i y lo devuelve. i debe ser una posición de índice válida en la matriz (es decir, 0 <= i < size()).

Si no se utiliza el valor devuelto, removeAt() resulta más eficiente.

Véase también removeAt().

QVariantList QJsonArray::toVariantList() const

Convierte este objeto en un ` QVariantList`.

Devuelve el mapa creado.

QJsonArray QJsonArray::operator+(const QJsonValue &value) const

Devuelve un array que contiene todos los elementos de este array seguidos de la cadena « value » proporcionada.

Véase también operator+=().

QJsonArray &QJsonArray::operator+=(const QJsonValue &value)

Añade value a la matriz y devuelve una referencia a la propia matriz.

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

QJsonArray &QJsonArray::operator<<(const QJsonValue &value)

Añade value a la matriz y devuelve una referencia a la propia matriz.

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

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

La instrucción «move» asigna el valor de « other » a este array.

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

Asigna ` other ` a este array.

QJsonValueRef QJsonArray::operator[](qsizetype i)

Devuelve el valor situado en la posición de índice i como una referencia modificable. i debe ser una posición de índice válida en la matriz (es decir, 0 <= i < size()).

El valor devuelto es de tipo QJsonValueRef, una clase auxiliar para QJsonArray y QJsonObject. Cuando se obtiene un objeto de tipo QJsonValueRef, se puede utilizar como si fuera una referencia a un QJsonValue. Si se le asigna un valor, la asignación se aplicará al carácter situado en la QJsonArray de QJsonObject del que se obtuvo la referencia.

Véase también at().

QJsonValue QJsonArray::operator[](qsizetype i) const

Es lo mismo que ` at()`.

Esta es una función sobrecargada.

Elementos no miembros relacionados

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

Devuelve ` true ` si la matriz ` lhs ` no es igual a ` rhs`; en caso contrario, devuelve ` false `.

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

Devuelve « true » si el array « lhs » es igual a « rhs »; en caso contrario, devuelve « false ».

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