QMultiMap::const_iterator Class
class QMultiMap::const_iteratorLa clase ` QMultiMap::const_iterator ` proporciona un iterador `const` al estilo STL para ` QMultiMap`. Más...
Tipos públicos
Funciones públicas
| const_iterator() | |
| const_iterator(const QMultiMap<Key, T>::iterator &other) | |
| const Key & | key() const |
| const T & | value() const |
| const T & | operator*() const |
| QMultiMap<Key, T>::const_iterator & | operator++() |
| QMultiMap<Key, T>::const_iterator | operator++(int) |
| QMultiMap<Key, T>::const_iterator & | operator--() |
| QMultiMap<Key, T>::const_iterator | operator--(int) |
| const T * | operator->() const |
Elementos no miembros relacionados
| bool | operator!=(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::const_iterator &rhs) |
| bool | operator==(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::const_iterator &rhs) |
Descripción detallada
QMultiMap<Key, T>::const_iterator permite iterar sobre un objeto de tipo QMultiMap. Si se desea modificar el objeto de tipo QMultiMap mientras se itera sobre él, se debe utilizar en su lugar QMultiMap::iterator. Por lo general, es una buena práctica utilizar también QMultiMap::const_iterator en un QMultiMap no const, a menos que necesites modificar el QMultiMap a través del iterador. Los iteradores const son ligeramente más rápidos y pueden mejorar la legibilidad del código.
El constructor predeterminado de ` QMultiMap::const_iterator ` crea un iterador no inicializado. Debes inicializarlo utilizando una función de ` QMultiMap `, como ` QMultiMap::cbegin()`, ` QMultiMap::cend()` o ` QMultiMap::constFind()`, antes de poder empezar a iterar. A continuación se muestra un bucle típico que imprime todos los pares (clave, valor) almacenados en un mapa:
QMultiMap<QString, int> multimap;
multimap.insert("January", 1);
multimap.insert("February", 2);
//...
multimap.insert("December", 12);
for (auto i = multimap.cbegin(), end = multimap.cend(); i != end; ++i)
cout << qPrintable(i.key()) << ": " << i.value() << endl;A continuación se muestra un ejemplo que elimina todos los elementos cuyo valor sea mayor que 10:
QMultiMap<QString, int>::const_iterator i = multimap.cbegin();
while (i != multimap.cend()) {
if (i.value() > 10)
i = multimap.erase(i);
else
++i;
}A diferencia de QMultiHash, que almacena sus elementos en un orden arbitrario, QMultiMap almacena sus elementos ordenados por clave. Los elementos que comparten la misma clave aparecerán consecutivamente, desde el valor insertado más recientemente hasta el menos reciente.
Se pueden utilizar varios iteradores en el mismo multimapa. Si añades elementos al mapa, los iteradores existentes seguirán siendo válidos. Si eliminas elementos del mapa, los iteradores que apunten a los elementos eliminados se convertirán en iteradores colgantes.
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 obtener más información, consulta «Problema con los iteradores de compartición implícita».
Véase también « QMultiMap::iterator », « QMultiMap::key_iterator » y « QMultiMap::const_key_value_iterator ».
Documentación sobre tipos de miembros
[alias] const_iterator::iterator_category
Sinónimo de `std::bidirectional_iterator_tag ` que indica que este iterador es bidireccional.
Documentación de las funciones miembro
[default] const_iterator::const_iterator()
Crea un iterador no inicializado.
No se deben invocar funciones como key(), value() ni el operador++() en un iterador no inicializado. Utiliza el operador=() para asignarle un valor antes de utilizarlo.
Véase también QMultiMap::constBegin() y QMultiMap::constEnd().
const_iterator::const_iterator(const QMultiMap<Key, T>::iterator &other)
Crea una copia de other.
const Key &const_iterator::key() const
Devuelve la clave del elemento actual.
Véase también value().
const T &const_iterator::value() const
Devuelve el valor del elemento actual.
Véase también key() y operator*().
const T &const_iterator::operator*() const
Devuelve el valor del elemento actual.
Equivale a value().
Véase también key().
QMultiMap<Key, T>::const_iterator &const_iterator::operator++()
El operador prefijo « ++ » (++i) hace avanzar el iterador al siguiente elemento del mapa y devuelve un iterador al nuevo elemento actual.
La llamada a esta función en ` QMultiMap::end()` da lugar a resultados indefinidos.
Véase también ` operator--()`.
QMultiMap<Key, T>::const_iterator const_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.
QMultiMap<Key, T>::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 sobre ` QMultiMap::begin()` da lugar a resultados indefinidos.
Véase también operator++().
QMultiMap<Key, T>::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.
const T *const_iterator::operator->() const
Devuelve un puntero al valor del elemento actual.
Véase también value().
Elementos no miembros relacionados
bool operator!=(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::const_iterator &rhs)
Devuelve ` true ` si ` lhs ` apunta a un elemento distinto del iterador ` rhs `; en caso contrario, devuelve ` false`.
Véase también operator==().
bool operator==(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::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!=().
© 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.