En esta página

QCborMap::Iterator Class

class QCborMap::Iterator

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

Comparaciones de QCborMap::Iterator

CategoríaTipos comparables
strongQCborMap::Iterator
strongConstIterator.

Tipos públicos

Funciones públicas

Iterator()
Iterator(const QCborMap::Iterator &other)
~Iterator()
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 recorrer un objeto ` QCborMap ` y modificar el valor (pero no la clave) almacenado bajo una clave concreta. Si desea recorrer un `const QCborMap`, debe utilizar ` QCborMap::ConstIterator`. Por lo general, es recomendable utilizar ` QCborMap::ConstIterator ` también con un ` QCborMap ` no constante, a menos que necesite modificar el ` QCborMap ` a través del iterador. Los iteradores constantes son ligeramente más rápidos y mejoran la legibilidad del código.

Debes inicializar el iterador utilizando una función QCborMap como QCborMap::begin(), QCborMap::end() o QCborMap::find() antes de poder comenzar a iterar.

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

Véase también QCborMap::ConstIterator.

Documentación sobre los tipos de miembro

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

[constexpr noexcept default] 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 QCborMap::begin() y QCborMap::end().

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

Crea un iterador como copia de ` other`.

[constexpr noexcept default] Iterator::~Iterator()

Elimina la instancia de Iterator.

QCborValue 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 ` QCborMap::erase()` seguido de ` QCborMap::insert()`.

Véase también ` value()`.

QCborValueRef Iterator::value() const

Devuelve una referencia modificable al valor del elemento actual.

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

El valor devuelto es de tipo QCborValueRef, una clase auxiliar 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 un valor, 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 de dicho elemento.

El segundo elemento del par es de tipo QCborValueRef, una clase auxiliar 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 un valor, la asignación se aplicará al elemento de 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 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éase también operator-().

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

El operador prefijo « ++ », ++i, hace avanzar el iterador hasta el siguiente elemento del mapa y devuelve dicho iterador.

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

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

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

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

Se trata de una función sobrecargada.

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

Avanza el iterador 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 situado en el iterador j con respecto al elemento situado en este iterador. Si el elemento situado en j se encuentra antes de este momento, el valor devuelto es negativo.

Véase también operator+().

QCborMap::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+()`.

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

El operador prefijo « -- », --i, convierte el elemento anterior en el actual y devuelve este iterador.

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

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

QCborMap::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.

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

Hace que el iterador retroceda 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)

Convierte este iterador en una copia de other y devuelve una referencia a este iterador.

Elementos no miembros relacionados

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

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

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

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

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

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

Devuelve ` true ` si la entrada del mapa a la que apunta el iterador ` lhs ` aparece antes que la entrada a la que apunta el iterador ` rhs `.

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

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

Devuelve ` true ` si la entrada del mapa a la que apunta el iterador ` lhs ` aparece antes que la entrada a la que apunta el iterador ` rhs `, o si ambas entradas son la misma.

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

[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &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::ConstIterator &rhs)

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

Devuelve ` true ` si la entrada del mapa a la que apunta el iterador ` lhs ` se encuentra después de la entrada a la que apunta el iterador ` rhs `.

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

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

Devuelve ` true ` si la entrada del mapa a la que apunta el iterador ` lhs ` se encuentra después de la entrada a la que apunta el iterador ` rhs `, o si es la misma entrada.

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