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 |
- Lista de todos los miembros, incluidos los miembros heredados
- QJsonArray forma parte del soporte para JSON en Qt y de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QJsonArray
| Categoría | Tipos comparables |
|---|---|
| igualdad | QJsonArray |
| igualdad | QJsonValue. |
Tipos públicos
| class | const_iterator |
| class | iterator |
| ConstIterator | |
| Iterator | |
| const_pointer | |
| const_reference | |
| difference_type | |
| pointer | |
| reference | |
| size_type | |
| value_type |
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) |
Elementos no miembros relacionados
| 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.