QJsonObject::const_iterator Class
class QJsonObject::const_iteratorLa clase ` QJsonObject::const_iterator ` proporciona un iterador `const` al estilo STL para ` QJsonObject`. Más...
- Lista de todos los miembros, incluidos los heredados
- const_iterator forma parte del soporte para JSON en Qt.
Comparaciones de QJsonObject::const_iterator
| Categoría | Tipos comparables |
|---|---|
| strong | QJsonObject::const_iterator |
| strong | QJsonObject::iterator. |
Tipos públicos
Funciones públicas
| const_iterator() | |
| const_iterator(const QJsonObject::iterator &other) | |
| const_iterator(const QJsonObject::const_iterator &other) | |
| QString | key() const |
(since 6.10) QAnyStringView | keyView() const |
| QJsonValueConstRef | value() const |
| const QJsonValueConstRef | operator*() const |
| QJsonObject::const_iterator | operator+(qsizetype j) const |
| QJsonObject::const_iterator & | operator++() |
| QJsonObject::const_iterator | operator++(int) |
| QJsonObject::const_iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QJsonObject::const_iterator other) const |
| QJsonObject::const_iterator | operator-(qsizetype j) const |
| QJsonObject::const_iterator & | operator--() |
| QJsonObject::const_iterator | operator--(int) |
| QJsonObject::const_iterator & | operator-=(qsizetype j) |
| const QJsonValueConstRef * | operator->() const |
| QJsonValueConstRef | operator[](qsizetype j) const |
Elementos no miembros relacionados
| bool | operator!=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator<(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator<=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator==(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator>(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator>=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
Descripción detallada
QJsonObject::const_iterator permite iterar sobre un ` QJsonObject`. Si desea modificar el ` QJsonObject ` mientras itera sobre él, debe utilizar ` QJsonObject::iterator ` en su lugar. Por lo general, es una buena práctica utilizar ` QJsonObject::const_iterator ` también con un ` QJsonObject ` no constante, a menos que necesite cambiar 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::const_iterator crea un iterador no inicializado. Debes inicializarlo utilizando una función QJsonObject como QJsonObject::constBegin(), QJsonObject::constEnd() 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» si se modifica el objeto.
Véase también QJsonObject::iterator, Compatibilidad con JSON en Qt y Guardar y cargar un juego.
Documentación sobre tipos de miembros
const_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
const_iterator::const_iterator()
Crea un iterador no inicializado.
No se deben invocar funciones como key(), value() y el operador++() en un iterador no inicializado. Utiliza el operador=() para asignarle un valor antes de utilizarlo.
Véase también QJsonObject::constBegin() y QJsonObject::constEnd().
const_iterator::const_iterator(const QJsonObject::iterator &other)
Crea una copia de other.
[constexpr noexcept default] const_iterator::const_iterator(const QJsonObject::const_iterator &other)
Crea una instancia de ` const_iterator` mediante copia.
QString const_iterator::key() const
Devuelve la clave del elemento actual.
Véase también value() y keyView().
[since 6.10] QAnyStringView const_iterator::keyView() const
Devuelve la clave del elemento actual como un objeto ` QAnyStringView`. Esta función no asigna memoria.
Dado que QJsonObject almacena claves en US-ASCII, UTF-8 o UTF-16, el objeto QAnyStringView devuelto puede estar en cualquiera de estas codificaciones.
Esta función se introdujo en Qt 6.10.
Véanse también value() y key().
QJsonValueConstRef const_iterator::value() const
Devuelve el valor del elemento actual.
Véase también key(), keyView() y operator*().
const QJsonValueConstRef const_iterator::operator*() const
Devuelve el valor del elemento actual.
Es lo mismo que value().
Véase también key() y keyView().
QJsonObject::const_iterator const_iterator::operator+(qsizetype j) const
Devuelve un iterador que apunta al elemento situado a una distanci j, hacia delante, desde este iterador. Si j es negativo, el iterador se desplaza hacia atrás.
Esta operación puede resultar lenta cuando los valores de ` j ` son muy grandes.
Véase también operator-().
QJsonObject::const_iterator &const_iterator::operator++()
El operador prefijo « ++ », ++i, hace avanzar el iterador al siguiente elemento del objeto y devuelve un iterador al nuevo elemento actual.
Llamar a esta función en QJsonObject::end() da lugar a resultados indefinidos.
Véase también operator--().
QJsonObject::const_iterator const_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::const_iterator &const_iterator::operator+=(qsizetype j)
Avanza el iterador j elementos. Si j es negativo, el iterador retrocede.
Esta operación puede resultar lenta si los valores de ` j ` son muy grandes.
Véanse también operator-=() y operator+().
qsizetype const_iterator::operator-(QJsonObject::const_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::const_iterator const_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.
Esta operación puede resultar lenta cuando los valores de ` j ` son muy grandes.
Véase también operator+().
QJsonObject::const_iterator &const_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 en ` QJsonObject::begin()` da lugar a resultados indefinidos.
Véase también operator++().
QJsonObject::const_iterator const_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::const_iterator &const_iterator::operator-=(qsizetype j)
Hace que el iterador retroceda j elementos. Si j es negativo, el iterador avanza.
Esta operación puede resultar lenta con valores grandes de j.
Véanse también operator+=() y operator-().
const QJsonValueConstRef *const_iterator::operator->() const
Devuelve un puntero al elemento actual.
QJsonValueConstRef const_iterator::operator[](qsizetype j) const
Devuelve el elemento situado en la posición 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++.
Véase también operator+().
Elementos no miembros relacionados
[noexcept] bool operator!=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs)
Devuelve ` true ` si ` lhs ` apunta a un elemento distinto del del iterador ` rhs `; en caso contrario, devuelve ` false`.
Véase también operator==().
[noexcept] bool operator<(const QJsonObject::const_iterator &lhs, const QJsonObject::const_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::const_iterator &lhs, const QJsonObject::const_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::const_iterator &lhs, const QJsonObject::const_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::const_iterator &lhs, const QJsonObject::const_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::const_iterator &lhs, const QJsonObject::const_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.