QJsonArray::iterator Class
class QJsonArray::iteratorLa clase ` QJsonArray::iterator ` proporciona un iterador no constante, al estilo de la STL, para ` QJsonArray`. Más información...
Comparaciones de QJsonArray::iterator
| Categoría | Tipos comparables |
|---|---|
| strong | QJsonArray::iterator |
| strong | QJsonArray::const_iterator. |
Tipos públicos
Funciones públicas
| iterator() | |
| iterator(const QJsonArray::iterator &other) | |
| QJsonValueRef | operator*() const |
| QJsonArray::iterator | operator+(qsizetype j) const |
| QJsonArray::iterator & | operator++() |
| QJsonArray::iterator | operator++(int) |
| QJsonArray::iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QJsonArray::iterator other) const |
| QJsonArray::iterator | operator-(qsizetype j) const |
| QJsonArray::iterator & | operator--() |
| QJsonArray::iterator | operator--(int) |
| QJsonArray::iterator & | operator-=(qsizetype j) |
| const QJsonValueConstRef * | operator->() const |
| QJsonValueRef | operator[](qsizetype j) const |
Elementos no miembros relacionados
| bool | operator!=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator!=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator<(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator<(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator<=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator<=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator==(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator==(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator>(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator>(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator>=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator>=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
Descripción detallada
QJsonArray::iterator permite iterar sobre un ` QJsonArray ` y modificar el elemento de la matriz asociado al iterador. Si deseas iterar sobre un `const QJsonArray`, utiliza en su lugar ` QJsonArray::const_iterator `. Por lo general, es una buena práctica utilizar ` QJsonArray::const_iterator ` también con un ` QJsonArray ` no const, a menos que necesites modificar el ` QJsonArray ` a través del iterador. Los iteradores const son ligeramente más rápidos y mejoran la legibilidad del código.
El constructor predeterminado de ` QJsonArray::iterator ` crea un iterador sin inicializar. Debes inicializarlo utilizando una función ` QJsonArray `, como ` QJsonArray::begin()`, ` QJsonArray::end()` o ` QJsonArray::insert()`, antes de poder comenzar a iterar.
La mayoría de las funciones ` QJsonArray ` aceptan un índice entero en lugar de un iterador. Por ese motivo, los iteradores rara vez resultan útiles en relación con ` QJsonArray`. Un caso en el que los iteradores al estilo STL sí tienen sentido es como argumentos de ` generic algorithms`.
Se pueden utilizar varios iteradores en la misma matriz. Sin embargo, hay que tener en cuenta que cualquier llamada a una función no const realizada sobre ` QJsonArray ` hará que todos los iteradores existentes queden indefinidos.
Véase también QJsonArray::const_iterator.
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.
Documentación de las funciones miembro
iterator::iterator()
Crea un iterador no inicializado.
No se deben invocar funciones como `operator*()` y `operator++()` en un iterador no inicializado. Utiliza `operator=()` para asignarle un valor antes de utilizarlo.
Véase también QJsonArray::begin() y QJsonArray::end().
[constexpr noexcept default] iterator::iterator(const QJsonArray::iterator &other)
Crea una instancia de ` iterator` mediante copia.
QJsonValueRef iterator::operator*() const
Devuelve una referencia modificable al elemento actual.
Se puede cambiar el valor de un elemento utilizando el operador *() en el lado izquierdo 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 carácter del QJsonArray de QJsonObject del que se obtuvo la referencia.
QJsonArray::iterator iterator::operator+(qsizetype j) const
Devuelve un iterador que apunta al elemento situado a j posiciones por delante de este iterador. Si j es negativo, el iterador se desplaza hacia atrás.
Véanse también operator-() y operator+=().
QJsonArray::iterator &iterator::operator++()
El operador prefijo « ++ », ++it, avanza el iterador hasta el siguiente elemento del array y devuelve un iterador que apunta al nuevo elemento actual.
La llamada a esta función en QJsonArray::end() da lugar a resultados indefinidos.
Véase también ` operator--()`.
QJsonArray::iterator iterator::operator++(int)
El operador postfijo « ++ », it++, avanza el iterador hasta el siguiente elemento del array y devuelve un iterador que apunta al elemento que se estaba procesando anteriormente.
Se trata de una función sobrecargada.
QJsonArray::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-(QJsonArray::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.
QJsonArray::iterator iterator::operator-(qsizetype j) const
Devuelve un iterador al elemento situado a j posiciones hacia atrás desde este iterador. Si j es negativo, el iterador avanza.
Véanse también operator+() y operator-=().
QJsonArray::iterator &iterator::operator--()
El operador prefijo « -- », --it, convierte el elemento anterior en el elemento actual y devuelve un iterador al nuevo elemento actual.
La llamada a esta función en QJsonArray::begin() da lugar a resultados indefinidos.
Véase también ` operator++()`.
QJsonArray::iterator iterator::operator--(int)
El operador postfijo « -- », it--, convierte el elemento anterior en el elemento actual y devuelve un iterador al elemento que era el actual anteriormente.
Se trata de una función sobrecargada.
QJsonArray::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-().
const QJsonValueConstRef *iterator::operator->() const
Devuelve un puntero a una referencia modificable 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 QJsonArray se comporten como punteros de C++.
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 operator+().
Elementos no miembros relacionados
[noexcept] bool operator!=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator!=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Devuelve ` true ` si ` lhs ` apunta a un elemento distinto al del iterador ` rhs `; en caso contrario, devuelve ` false`.
Véase también operator==().
[noexcept] bool operator<(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator<(const QJsonArray::iterator &lhs, const QJsonArray::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 QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator<=(const QJsonArray::iterator &lhs, const QJsonArray::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 QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator==(const QJsonArray::iterator &lhs, const QJsonArray::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 QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator>(const QJsonArray::iterator &lhs, const QJsonArray::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 QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator>=(const QJsonArray::iterator &lhs, const QJsonArray::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.