QMultiMap::key_iterator Class
class QMultiMap::key_iteratorLa clase ` QMultiMap::key_iterator ` proporciona un iterador `const` al estilo de la STL para las claves ` QMultiMap `. Más información...
Funciones públicas
| key_iterator() | |
| QMultiMap<Key, T>::const_iterator | base() const |
| bool | operator!=(QMultiMap<Key, T>::key_iterator other) const |
| const Key & | operator*() const |
| QMultiMap<Key, T>::key_iterator & | operator++() |
| QMultiMap<Key, T>::key_iterator | operator++(int) |
| QMultiMap<Key, T>::key_iterator & | operator--() |
| QMultiMap<Key, T>::key_iterator | operator--(int) |
| const Key * | operator->() const |
| bool | operator==(QMultiMap<Key, T>::key_iterator other) const |
Descripción detallada
QMultiMap::key_iterator es esencialmente igual que QMultiMap::const_iterator, con la diferencia de que los operadores *() y ->() devuelven una clave en lugar de un valor.
Para la mayoría de los casos, se deben utilizar QMultiMap::iterator y QMultiMap::const_iterator; puedes acceder fácilmente a la clave llamando a QMultiMap::iterator::key():
for (auto it = multimap.cbegin(), end = multimap.cend(); it != end; ++it) {
cout << "The key: " << it.key() << endl;
cout << "The value: " << qPrintable(it.value()) << endl;
cout << "Also the value: " << qPrintable(*it) << endl;
}Sin embargo, para lograr la interoperabilidad entre las claves de QMultiMap y los algoritmos de estilo STL, necesitamos un iterador que desreferencie a una clave en lugar de a un valor. Con QMultiMap::key_iterator podemos aplicar un algoritmo a un rango de claves sin tener que llamar a QMultiMap::keys(), lo cual es ineficiente, ya que supone una iteración QMultiMap y la asignación de memoria para crear un QList temporal.
// Ineficaz, keys() es costosa
QList<int> keys = multimap.keys();
int numPrimes = std::count_if(multimap.cbegin(), multimap.cend(), isPrimeNumber);
qDeleteAll(multimap2.keys());
// Eficaz, no requiere asignación de memoria
int primeNums = std::count_if(multimap.keyBegin(), multimap.keyEnd(), isPrimeNumber);
qDeleteAll(multimap2.keyBegin(), multimap2.keyEnd());QMultiMap::key_iterator Si es `const`, no es posible modificar la clave.
El constructor predeterminado de ` QMultiMap::key_iterator ` crea un iterador no inicializado. Debes inicializarlo utilizando una función ` QMultiMap `, como ` QMultiMap::keyBegin()` o ` QMultiMap::keyEnd()`.
Advertencia: Los iteradores de contenedores compartidos implícitamente no funcionan exactamente igual que los iteradores de la STL. Se debe evitar copiar un contenedor mientras haya iteradores activos en él. Para obtener más información, consulta el problema de los iteradores de uso compartido implícito.
Véase también « QMultiMap::const_iterator » y « QMultiMap::iterator ».
Documentación de funciones miembro
[default] key_iterator::key_iterator()
Crea por defecto una instancia de ` key_iterator`.
QMultiMap<Key, T>::const_iterator key_iterator::base() const
Devuelve el objeto ` const_iterator ` subyacente en el que se basa este ` key_iterator `.
bool key_iterator::operator!=(QMultiMap<Key, T>::key_iterator other) const
Devuelve ` true ` si ` other ` apunta a un elemento distinto de este iterador; en caso contrario, devuelve ` false`.
Véase también operator==().
const Key &key_iterator::operator*() const
Devuelve la clave del elemento actual.
QMultiMap<Key, T>::key_iterator &key_iterator::operator++()
El operador prefijo « ++ » (++i) hace avanzar el iterador al siguiente elemento del hash y devuelve un iterador al nuevo elemento actual.
Llamar a esta función sobre ` QMultiMap::keyEnd()` da lugar a resultados indefinidos.
Véase también operator--().
QMultiMap<Key, T>::key_iterator key_iterator::operator++(int)
El operador postfijo « ++ » (i++) avanza el iterador hasta el siguiente elemento del hash y devuelve un iterador al elemento anterior.
Se trata de una función sobrecargada.
QMultiMap<Key, T>::key_iterator &key_iterator::operator--()
El operador prefijo « -- » (--i) convierte el elemento precedente en el elemento actual y devuelve un iterador que apunta al nuevo elemento actual.
La llamada a esta función sobre ` QMultiMap::keyBegin()` da lugar a resultados indefinidos.
Véase también ` operator++()`.
QMultiMap<Key, T>::key_iterator key_iterator::operator--(int)
El operador postfijo « -- » (i--) convierte el elemento anterior en el actual y devuelve un iterador que apunta al elemento anterior.
Se trata de una función sobrecargada.
const Key *key_iterator::operator->() const
Devuelve un puntero a la clave del elemento actual.
bool key_iterator::operator==(QMultiMap<Key, T>::key_iterator other) const
Devuelve ` true ` si ` other ` apunta al mismo elemento que este iterador; 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.