En esta página

QJsonObject::iterator Class

class QJsonObject::iterator

La clase ` QJsonObject::iterator ` proporciona un iterador no constante, al estilo de la STL, para ` QJsonObject`. Más información...

Comparaciones de QJsonObject::iterator

CategoríaTipos comparables
fuerteQJsonObject::iterator
strongQJsonObject::const_iterator.

Tipos públicos

Funciones públicas

iterator()
iterator(const QJsonObject::iterator &other)
QString key() const
(since 6.10) QAnyStringView keyView() const
QJsonValueRef value() const
QJsonValueRef operator*() const
QJsonObject::iterator operator+(qsizetype j) const
QJsonObject::iterator &operator++()
QJsonObject::iterator operator++(int)
QJsonObject::iterator &operator+=(qsizetype j)
qsizetype operator-(QJsonObject::iterator other) const
QJsonObject::iterator operator-(qsizetype j) const
QJsonObject::iterator &operator--()
QJsonObject::iterator operator--(int)
QJsonObject::iterator &operator-=(qsizetype j)
QJsonValueRef *operator->()
const QJsonValueConstRef *operator->() const
QJsonValueRef operator[](qsizetype j) const
bool operator!=(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)
bool operator!=(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)
bool operator<(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)
bool operator<(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)
bool operator<=(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)
bool operator<=(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)
bool operator==(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)
bool operator==(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)
bool operator>(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)
bool operator>(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)
bool operator>=(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)
bool operator>=(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Descripción detallada

QJsonObject::iterator permite recorrer un objeto ` QJsonObject ` y modificar el valor (pero no la clave) almacenado bajo una clave concreta. Si deseas recorrer un `const QJsonObject`, debes utilizar ` QJsonObject::const_iterator`. Por lo general, es una buena práctica utilizar ` QJsonObject::const_iterator ` también con un ` QJsonObject ` no constante, a menos que necesites modificar el ` QJsonObject ` a través del iterador. Los iteradores constantes son ligeramente más rápidos y mejoran la legibilidad del código.

El constructor predeterminado QJsonObject::iterator crea un iterador no inicializado. Debes inicializarlo utilizando una función QJsonObject como QJsonObject::begin(), QJsonObject::end() o QJsonObject::find() antes de poder comenzar a iterar.

Se pueden utilizar varios iteradores en el mismo objeto. Sin embargo, los iteradores existentes quedarán «colgados» una vez que se modifique el objeto.

Véase también QJsonObject::const_iterator, Compatibilidad con JSON en Qt y Guardar y cargar un juego.

Documentación sobre tipos de miembros

iterator::iterator_category

Sinónimo de std::random_access_iterator_tag que indica que este iterador es un iterador de acceso aleatorio.

Nota: En las versiones de Qt anteriores a la 5.6, se estableció por error como std::bidirectional_iterator_tag.

Documentación de las funciones miembro

iterator::iterator()

Crea un iterador no inicializado.

No se deben invocar funciones como key(), value() ni el operador++() sobre un iterador no inicializado. Utiliza el operador=() para asignarle un valor antes de utilizarlo.

Véase también QJsonObject::begin() y QJsonObject::end().

[constexpr noexcept default] iterator::iterator(const QJsonObject::iterator &other)

Crea una instancia de ` iterator` mediante copia.

QString iterator::key() const

Devuelve la clave del elemento actual.

No hay una forma directa de cambiar la clave de un elemento mediante un iterador, aunque se puede hacer llamando a ` QJsonObject::erase()` seguido de ` QJsonObject::insert()`.

Véanse también value() y keyView().

[since 6.10] QAnyStringView iterator::keyView() const

Devuelve la clave del elemento actual como un objeto ` QAnyStringView`. Esta función no asigna memoria.

Dado que QJsonObject almacena las claves en US-ASCII, UTF-8 o UTF-16, el objeto QAnyStringView devuelto puede estar en cualquiera de estas codificaciones.

No hay una forma directa de cambiar la clave de un elemento mediante un iterador, aunque se puede hacer llamando a ` QJsonObject::erase()` seguida de ` QJsonObject::insert()`.

Esta función se introdujo en Qt 6.10.

Véanse también key() y value().

QJsonValueRef iterator::value() const

Devuelve una referencia modificable al valor del elemento actual.

Puedes cambiar el valor de un elemento utilizando value() a la izquierda de una asignación.

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 elemento de QJsonArray o QJsonObject del que se obtuvo la referencia.

Véase también key(), keyView() y operator*().

QJsonValueRef iterator::operator*() const

Devuelve una referencia modificable al valor del elemento actual.

Es lo mismo que ` value()`.

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 elemento de ` QJsonArray ` o ` QJsonObject ` del que se obtuvo la referencia.

Véase también key() y keyView().

QJsonObject::iterator iterator::operator+(qsizetype j) const

Devuelve un iterador al elemento situado a « j » posiciones por delante de este iterador. Si « j » es negativo, el iterador se desplaza hacia atrás.

Véase también ` operator-()`.

QJsonObject::iterator &iterator::operator++()

El operador prefijo « ++ », ++i, hace avanzar el iterador al siguiente elemento del objeto y devuelve un iterador al nuevo elemento actual.

La llamada a esta función sobre QJsonObject::end() da lugar a resultados indefinidos.

Véase también operator--().

QJsonObject::iterator iterator::operator++(int)

El operador postfijo « ++ », i++, hace avanzar el iterador al siguiente elemento del objeto y devuelve un iterador al elemento que era el actual anteriormente.

Se trata de una función sobrecargada.

QJsonObject::iterator &iterator::operator+=(qsizetype j)

Avanza el iterador j elementos. Si j es negativo, el iterador retrocede.

Véanse también operator-=() y operator+().

qsizetype iterator::operator-(QJsonObject::iterator other) const

Devuelve el número de elementos que hay entre el elemento al que apunta other y el elemento al que apunta este iterador.

QJsonObject::iterator iterator::operator-(qsizetype j) const

Devuelve un iterador que apunta al elemento situado a « j » posiciones hacia atrás desde este iterador. Si « j » es negativo, el iterador avanza.

Véase también operator+().

QJsonObject::iterator &iterator::operator--()

El operador prefijo « -- », --i, convierte el elemento anterior en el elemento actual y devuelve un iterador que apunta al nuevo elemento actual.

La llamada a esta función sobre QJsonObject::begin() da lugar a resultados indefinidos.

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

QJsonObject::iterator iterator::operator--(int)

El operador postfijo « -- », i--, convierte el elemento anterior en el elemento actual y devuelve un iterador que apunta al elemento que era el actual anteriormente.

Se trata de una función sobrecargada.

QJsonObject::iterator &iterator::operator-=(qsizetype j)

Hace que el iterador retroceda j elementos. Si j es negativo, el iterador avanza.

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

QJsonValueRef *iterator::operator->()

Devuelve un puntero a una referencia modificable del elemento actual.

const QJsonValueConstRef *iterator::operator->() const

Devuelve un puntero a una referencia constante al elemento actual.

QJsonValueRef iterator::operator[](qsizetype j) const

Devuelve una referencia modificable al elemento situado en el desplazamiento j a partir del elemento al que apunta este iterador (el elemento situado en la posición *this + j).

Esta función se proporciona para que los iteradores de QJsonObject se comporten como punteros de C++.

El valor de retorno 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 elemento de QJsonArray o QJsonObject del que se obtuvo la referencia.

Véase también operator+().

Elementos no miembros relacionados

[noexcept] bool operator!=(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)

[noexcept] bool operator!=(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Devuelve ` true ` si ` lhs ` apunta a un elemento distinto del iterador ` rhs `; en caso contrario, devuelve ` false`.

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

[noexcept] bool operator<(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)

[noexcept] bool operator<(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Devuelve ` true ` si el elemento al que apunta el iterador ` lhs ` es menor que el elemento al que apunta el iterador ` rhs `.

[noexcept] bool operator<=(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)

[noexcept] bool operator<=(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Devuelve ` true ` si el elemento al que apunta el iterador ` lhs ` es menor o igual que el elemento al que apunta el iterador ` rhs `.

[noexcept] bool operator==(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)

[noexcept] bool operator==(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Devuelve ` true ` si ` lhs ` apunta al mismo elemento que el iterador ` rhs `; en caso contrario, devuelve ` false`.

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

[noexcept] bool operator>(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)

[noexcept] bool operator>(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Devuelve ` true ` si el elemento al que apunta el iterador ` lhs ` es mayor que el elemento al que apunta el iterador ` rhs `.

[noexcept] bool operator>=(const QJsonObject::iterator &lhs, const QJsonObject::const_iterator &rhs)

[noexcept] bool operator>=(const QJsonObject::iterator &lhs, const QJsonObject::iterator &rhs)

Devuelve ` true ` si el elemento al que apunta el iterador ` lhs ` es mayor o igual que el elemento al que apunta el iterador ` rhs `.

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