En esta página

QCborMap::Iterator Class

class QCborMap::Iterator

La clase QCborMap::Iterator proporciona un iterador no-const de estilo STL para QCborMap. Más...

Esta clase es fuertemente comparable.

Esta clase es fuertemente comparable con ConstIterator.

Tipos Públicos

Funciones Públicas

Iterator()
Iterator(const QCborMap::Iterator &other)
QCborValue key() const
QCborValueRef value() const
QCborMap::Iterator::value_type operator*() const
QCborMap::Iterator operator+(qsizetype j) const
QCborMap::Iterator &operator++()
QCborMap::Iterator operator++(int)
QCborMap::Iterator &operator+=(qsizetype j)
qsizetype operator-(QCborMap::Iterator j) const
QCborMap::Iterator operator-(qsizetype j) const
QCborMap::Iterator &operator--()
QCborMap::Iterator operator--(int)
QCborMap::Iterator &operator-=(qsizetype j)
const QCborValueConstRef *operator->() const
QCborMap::Iterator &operator=(const QCborMap::Iterator &other)
bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator<(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator<(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator==(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator>(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator>(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

Descripción detallada

QCborMap::Iterator permite iterar sobre un QCborMap y modificar el valor (pero no la clave) almacenado bajo una clave concreta. Si desea iterar sobre una const QCborMap, debe utilizar QCborMap::ConstIterator. Generalmente es una buena práctica usar QCborMap::ConstIterator sobre un QCborMap no-const también, a menos que necesite cambiar el QCborMap a través del iterador. Los iteradores const son ligeramente más rápidos y mejoran la legibilidad del código.

Debes inicializar el iterador usando una función QCborMap como QCborMap::begin(), QCborMap::end(), o QCborMap::find() antes de que puedas empezar a iterar..

Se pueden utilizar múltiples iteradores en el mismo objeto. Sin embargo, los iteradores existentes quedarán colgados una vez que se modifique el objeto.

Véase también QCborMap::ConstIterator.

Documentación de tipos de miembros

Iterator::iterator_category

Un 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

[constexpr noexcept] Iterator::Iterator()

Construye un iterador no inicializado.

Funciones como key(), value(), y operator++() no deben ser llamadas en un iterador no inicializado. Utilice operator=() para asignarle un valor antes de utilizarlo.

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

[constexpr noexcept] Iterator::Iterator(const QCborMap::Iterator &other)

Construye un iterador como copia de other.

QCborValue Iterator::key() const

Devuelve la clave del elemento actual.

No hay forma directa de cambiar la clave de un elemento a través de un iterador, aunque puede hacerse llamando a QCborMap::erase() seguido de QCborMap::insert().

Véase también value().

QCborValueRef Iterator::value() const

Devuelve una referencia modificable al valor del elemento actual.

Puede modificar el valor de una clave utilizando value() en el lado izquierdo de una asignación.

El valor devuelto es de tipo QCborValueRef, una clase de ayuda para QCborArray y QCborMap. Cuando se obtiene un objeto de tipo QCborValueRef, se puede utilizar como si fuera una referencia a QCborValue. Si se le asigna, la asignación se aplicará al elemento de QCborArray o QCborMap del que se obtuvo la referencia.

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

QCborMap::Iterator::value_type Iterator::operator*() const

Devuelve un par que contiene la clave del elemento actual y una referencia modificable al valor del elemento actual.

El segundo elemento del par es de tipo QCborValueRef, una clase de ayuda para QCborArray y QCborMap. Cuando se obtiene un objeto de tipo QCborValueRef, se puede utilizar como si fuera una referencia a un QCborValue. Si se le asigna, la asignación se aplicará al elemento del QCborArray o QCborMap del que se obtuvo la referencia.

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

QCborMap::Iterator Iterator::operator+(qsizetype j) const

Devuelve un iterador al elemento en j posiciones hacia adelante desde este iterador. Si j es negativo, el iterador va hacia atrás.

Véase también operator-().

QCborMap::Iterator &Iterator::operator++()

El operador prefijo ++, ++i, avanza el iterador al siguiente elemento del mapa y devuelve este iterador.

Llamar a esta función en QCborMap::end() conduce a resultados indefinidos.

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

QCborMap::Iterator Iterator::operator++(int)

El operador postfijo ++, i++, avanza el iterador al siguiente elemento del mapa y devuelve un iterador al elemento previamente actual.

Se trata de una función sobrecargada.

QCborMap::Iterator &Iterator::operator+=(qsizetype j)

Avanza el iterador en j elementos. Si j es negativo, el iterador retrocede. Devuelve una referencia a este iterador.

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

qsizetype Iterator::operator-(QCborMap::Iterator j) const

Devuelve la posición del elemento en el iterador j con respecto al elemento en este iterador. Si el elemento en j está adelantado con respecto a este iterador, el valor devuelto es negativo.

Véase también operator+().

QCborMap::Iterator Iterator::operator-(qsizetype j) const

Devuelve un iterador al elemento en j posiciones hacia atrás desde este iterador. Si j es negativo, el iterador va hacia adelante.

Véase también operator+().

QCborMap::Iterator &Iterator::operator--()

El operador prefijo --, --i, hace actual el elemento precedente y devuelve este iterador.

Llamar a esta función en QCborMap::begin() conduce a resultados indefinidos.

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

QCborMap::Iterator Iterator::operator--(int)

El operador postfijo --, i--, hace actual el elemento precedente y devuelve un iterador que apunta al elemento previamente actual.

Se trata de una función sobrecargada.

QCborMap::Iterator &Iterator::operator-=(qsizetype j)

Hace que el iterador retroceda en j elementos. Si j es negativo, el iterador avanza. Devuelve una referencia a este iterador.

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

const QCborValueConstRef *Iterator::operator->() const

Devuelve un puntero a una referencia modificable al valor del par actual.

QCborMap::Iterator &Iterator::operator=(const QCborMap::Iterator &other)

Hace de este iterador una copia de other y devuelve una referencia a este iterador.

No miembros relacionados

[noexcept] bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Devuelve true si lhs apunta a una entrada del mapa distinta del iterador rhs; en caso contrario devuelve false.

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

[noexcept] bool operator<(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator<(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Devuelve true si la entrada en el mapa apuntada por el iterador lhs ocurre antes que la entrada apuntada por el iterador rhs.

[noexcept] bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Devuelve true si la entrada en el mapa apuntada por el iterador lhs ocurre antes o es la misma entrada apuntada por el iterador rhs.

[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Devuelve true si lhs apunta a la misma entrada del mapa que el iterador rhs; en caso contrario devuelve false.

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

[noexcept] bool operator>(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator>(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Devuelve true si la entrada en el mapa apuntada por el iterador lhs ocurre después de la entrada apuntada por el iterador rhs.

[noexcept] bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Devuelve true si la entrada en el mapa apuntada por el iterador lhs ocurre después o es la misma entrada apuntada por 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.