En esta página

QKeyValueIterator Class

template <typename Key, typename T, typename Iterator, typename Traits> class QKeyValueIterator

Iterador que recorre los pares clave-valor de un contenedor asociativo. Más información...

Encabezado: #include <QKeyValueIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Funciones públicas

QKeyValueIterator()
QKeyValueIterator(Iterator o)
Iterator base() const
std::pair<Key, T> operator*() const
QKeyValueIterator<Key, T, Iterator, Traits> &operator++()
QKeyValueIterator<Key, T, Iterator, Traits> operator++(int)
QKeyValueIterator<Key, T, Iterator, Traits> &operator--()
QKeyValueIterator<Key, T, Iterator, Traits> operator--(int)
QKeyValueIterator<Key, T, Iterator, Traits>::pointer operator->() const
bool operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)
bool operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)

Descripción detallada

La clase QKeyValueIterator proporciona un iterador al estilo STL para devolver pares clave/valor de contenedores asociativos como QHash y QMap. El parámetro de plantilla Key especifica el tipo de clave, T especifica el tipo de valor, Iterator es el tipo de iterador subyacente y Traits especifica los rasgos del iterador. Admite la misma API que los contenedores asociativos de la STL, es decir, permite obtener un par clave/valor al iterar por el contenedor.

Esto permitirá una mejor interoperabilidad entre QMap, QHash y similares, y los algoritmos al estilo de la STL.

Advertencia: Los iteradores en contenedores compartidos implícitamente no funcionan exactamente igual que los iteradores de la STL. Debes evitar copiar un contenedor mientras haya iteradores activos en él. Para más información, consulta el problema de los iteradores en contenedores compartidos implícitamente.

Documentación de las funciones miembro

[default] QKeyValueIterator::QKeyValueIterator()

Crea un QKeyValueIterator por defecto.

[explicit constexpr noexcept(...)] QKeyValueIterator::QKeyValueIterator(Iterator o)

Crea un QKeyValueIterator a partir de o.

Nota: Esta función es «noexcept» cuando std::is_nothrow_move_constructible<Iterator>::value es « true ».

Iterator QKeyValueIterator::base() const

Devuelve el iterador subyacente en el que se basa este ` QKeyValueIterator `.

std::pair<Key, T> QKeyValueIterator::operator*() const

Devuelve la entrada actual como un par.

QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator++()

El operador prefijo « ++ » (++i) hace avanzar el iterador hasta el siguiente elemento del contenedor y devuelve el iterador.

Nota: Avanzar el iterador más allá de el end() del contenedor constituye un comportamiento indefinido.

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

QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator++(int)

El operador postfijo ` ++ ` (i++) avanza el iterador hasta el siguiente elemento del contenedor y devuelve el valor anterior del iterador.

Nota: Avanzar el iterador más allá del final del contenedor (end()) constituye un comportamiento indefinido.

Se trata de una función sobrecargada.

QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator--()

El operador prefijo c{–} (--i) hace retroceder el iterador hasta el elemento anterior del contenedor y devuelve el iterador.

Nota: Retroceder un iterador hasta antes de la llamada a `begin()` de su contenedor constituye un comportamiento indefinido.

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

QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator--(int)

El operador postfijo c{–} (i--) hace retroceder el iterador hasta el elemento anterior del contenedor y devuelve el valor anterior del iterador.

Nota: Retroceder un iterador hasta antes de la llamada a `begin()` de su contenedor constituye un comportamiento indefinido.

Se trata de una función sobrecargada.

QKeyValueIterator<Key, T, Iterator, Traits>::pointer QKeyValueIterator::operator->() const

Devuelve la entrada actual como un objeto similar a un puntero al par.

Véase también operator*().

Elementos no miembros relacionados

[noexcept] bool operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)

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

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

[noexcept] bool operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)

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

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

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