QMultiHash Class
template <typename Key, typename T> class QMultiHashLa clase QMultiHash proporciona una tabla hash multivalor. Más información...
| Encabezado: | #include <QMultiHash> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QMultiHash forma parte de las clases compartidas implícitamente y las clases contenedor.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QMultiHash
| Categoría | Tipos comparables |
|---|---|
| igualdad | QMultiHash |
Tipos públicos
| class | const_iterator |
| class | iterator |
| class | key_iterator |
| const_key_value_iterator | |
| key_value_iterator |
Funciones públicas
| QMultiHash() | |
| QMultiHash(const QHash<Key, T> &other) | |
| QMultiHash(std::initializer_list<std::pair<Key, T>> list) | |
| QMultiHash(InputIterator begin, InputIterator end) | |
(since 6.4) auto | asKeyValueRange() && |
(since 6.4) auto | asKeyValueRange() & |
(since 6.4) auto | asKeyValueRange() const && |
(since 6.4) auto | asKeyValueRange() const & |
| QMultiHash<Key, T>::iterator | begin() |
| QMultiHash<Key, T>::const_iterator | begin() const |
| QMultiHash<Key, T>::const_iterator | cbegin() const |
| QMultiHash<Key, T>::const_iterator | cend() const |
| void | clear() |
| QMultiHash<Key, T>::const_iterator | constBegin() const |
| QMultiHash<Key, T>::const_iterator | constEnd() const |
| QMultiHash<Key, T>::const_iterator | constFind(const Key &key, const T &value) const |
| QMultiHash<Key, T>::const_key_value_iterator | constKeyValueBegin() const |
| QMultiHash<Key, T>::const_key_value_iterator | constKeyValueEnd() const |
| bool | contains(const Key &key, const T &value) const |
| qsizetype | count(const Key &key, const T &value) const |
| QMultiHash<Key, T>::iterator | emplace(Key &&key, Args &&... args) |
| QMultiHash<Key, T>::iterator | emplace(const Key &key, Args &&... args) |
| QMultiHash<Key, T>::iterator | emplaceReplace(Key &&key, Args &&... args) |
| QMultiHash<Key, T>::iterator | emplaceReplace(const Key &key, Args &&... args) |
| QMultiHash<Key, T>::iterator | end() |
| QMultiHash<Key, T>::const_iterator | end() const |
| std::pair<QMultiHash<Key, T>::iterator, QMultiHash<Key, T>::iterator> | equal_range(const Key &key) |
| std::pair<QMultiHash<Key, T>::const_iterator, QMultiHash<Key, T>::const_iterator> | equal_range(const Key &key) const |
| QMultiHash<Key, T>::iterator | erase(QMultiHash<Key, T>::const_iterator pos) |
| QMultiHash<Key, T>::iterator | find(const Key &key, const T &value) |
| QMultiHash<Key, T>::const_iterator | find(const Key &key, const T &value) const |
| QMultiHash<Key, T>::iterator | insert(const Key &key, const T &value) |
(since 6.11) QMultiHash<Key, T>::iterator | insert(Key &&key, T &&value) |
(since 6.11) QMultiHash<Key, T>::iterator | insert(Key &&key, const T &value) |
(since 6.11) QMultiHash<Key, T>::iterator | insert(const Key &key, T &&value) |
| Key | key(const T &value) const |
| Key | key(const T &value, const Key &defaultKey) const |
| QMultiHash<Key, T>::key_iterator | keyBegin() const |
| QMultiHash<Key, T>::key_iterator | keyEnd() const |
| QMultiHash<Key, T>::key_value_iterator | keyValueBegin() |
| QMultiHash<Key, T>::const_key_value_iterator | keyValueBegin() const |
| QMultiHash<Key, T>::key_value_iterator | keyValueEnd() |
| QMultiHash<Key, T>::const_key_value_iterator | keyValueEnd() const |
| QList<Key> | keys() const |
| qsizetype | remove(const Key &key) |
| qsizetype | remove(const Key &key, const T &value) |
(since 6.1) qsizetype | removeIf(Predicate pred) |
| QMultiHash<Key, T>::iterator | replace(const Key &key, const T &value) |
| void | swap(QMultiHash<Key, T> &other) |
| T | take(const Key &key) |
| QList<Key> | uniqueKeys() const |
(since 6.0) QMultiHash<Key, T> & | unite(const QHash<Key, T> &other) |
| QMultiHash<Key, T> & | unite(const QMultiHash<Key, T> &other) |
| T | value(const Key &key) const |
| T | value(const Key &key, const T &defaultValue) const |
| QList<T> | values() const |
| QList<T> | values(const Key &key) const |
| QMultiHash<Key, T> | operator+(const QMultiHash<Key, T> &other) const |
| QMultiHash<Key, T> & | operator+=(const QMultiHash<Key, T> &other) |
| T & | operator[](const Key &key) |
Elementos no miembros relacionados
(since 6.1) qsizetype | erase_if(QMultiHash<Key, T> &hash, Predicate pred) |
| size_t | qHash(const QMultiHash<Key, T> &key, size_t seed = 0) |
| bool | operator!=(const QMultiHash<Key, T> &lhs, const QMultiHash<Key, T> &rhs) |
| QDataStream & | operator<<(QDataStream &out, const QMultiHash<Key, T> &hash) |
| bool | operator==(const QMultiHash<Key, T> &lhs, const QMultiHash<Key, T> &rhs) |
| QDataStream & | operator>>(QDataStream &in, QMultiHash<Key, T> &hash) |
Descripción detallada
QMultiHash<KEY, T> es una de las clases de contenedores genéricos de Qt, donde Key es el tipo utilizado para las claves de búsqueda y T es el tipo de valor asignado. Proporciona una tabla hash que permite múltiples valores para una misma clave.
QMultiHash refleja en gran medida la API de ` QHash`. Por ejemplo, se puede utilizar `isEmpty()` para comprobar si el hash está vacío, y se puede recorrer un `QMultiHash` utilizando las clases de iteradores de ` QHash` (por ejemplo, ` QHashIterator`). Sin embargo, a diferencia de QHash, ofrece una función insert() que permite insertar varios elementos con la misma clave. La función replace() se corresponde con QHash::insert(). También proporciona los prácticos operadores +() y +=().
A diferencia de QMultiMap, QMultiHash no garantiza el orden de los elementos insertados. Lo único que se garantiza es que los elementos que compartan la misma clave aparecerán de forma consecutiva, desde el valor insertado más recientemente hasta el menos reciente.
Ejemplo:
QMultiHash<QString, int> hash1, hash2, hash3;
hash1.insert("plenty", 100);
hash1.insert("plenty", 2000);
// hash1.size() == 2
hash2.insert("plenty", 5000);
// hash2.size() == 1
hash3 = hash1 + hash2;
// hash3.size() == 3A diferencia de QHash, QMultiHash no proporciona el operador []. Utiliza value() o replace() si deseas acceder al elemento insertado más recientemente con una clave determinada.
Si desea recuperar todos los valores de una única clave, puede utilizar values(const Key &key), que devuelve un QList<T>:
QList<int> values = hash.values("plenty");
for (auto i : std::as_const(values))
cout << i << endl;Los elementos que comparten la misma clave están disponibles ordenados de más reciente a menos reciente.
Un enfoque más eficiente consiste en llamar a find() para obtener el iterador de estilo STL del primer elemento con una clave e iterar a partir de ahí:
auto i = hash.constFind("plenty");
while (i != hash.cend() && i.key() == "plenty") {
cout << i.value() << endl;
++i;
}Los tipos de datos de clave y valor de `QMultiHash` deben ser tipos de datos asignables. No se puede, por ejemplo, almacenar un ` QWidget ` como valor; en su lugar, se debe almacenar un ` QWidget *`. Además, el tipo de clave de `QMultiHash` debe proporcionar el operador `==()`, y también debe existir una función ` qHash()` en el espacio de nombres del tipo que devuelva un valor hash para un argumento del tipo de la clave. Consulte la documentación de ` QHash ` para obtener más detalles.
Véase también QHash, QHashIterator, QMutableHashIterator y QMultiMap.
Documentación sobre tipos de miembros
QMultiHash::const_key_value_iterator
La definición de tipo `QMultiHash::const_key_value_iterator` proporciona un iterador `const` al estilo de la STL para ` QMultiHash`.
QMultiHash::const_key_value_iterator es esencialmente igual que ` QMultiHash::const_iterator `, con la diferencia de que el operador *() devuelve un par clave/valor en lugar de un valor.
Véase también ` QKeyValueIterator`.
QMultiHash::key_value_iterator
La definición de tipo `QMultiHash::key_value_iterator` proporciona un iterador al estilo STL para ` QMultiHash`.
QMultiHash::key_value_iterator es, en esencia, igual que QMultiHash::iterator, con la diferencia de que el operador *() devuelve un par clave/valor en lugar de un valor.
Véase también QKeyValueIterator.
Documentación de las funciones miembro
[noexcept default] QMultiHash::QMultiHash()
Crea un hash vacío.
[explicit] QMultiHash::QMultiHash(const QHash<Key, T> &other)
Crea una copia de ` other ` (que puede ser un ` QHash ` o un `QMultiHash`).
QMultiHash::QMultiHash(std::initializer_list<std::pair<Key, T>> list)
Crea un multi-hash con una copia de cada uno de los elementos de la lista de inicialización list.
template <typename InputIterator> QMultiHash::QMultiHash(InputIterator begin, InputIterator end)
Crea un multi-hash con una copia de cada uno de los elementos del rango del iterador [begin, end). O bien los elementos sobre los que se itera en el rango deben ser objetos con los miembros de datos first y second (como std::pair), convertibles en Key y en T, respectivamente; o bien los iteradores deben tener las funciones miembro key() y value(), que devuelvan una clave convertible en Key y un valor convertible en T, respectivamente.
[since 6.4] auto QMultiHash::asKeyValueRange() &&
[since 6.4] auto QMultiHash::asKeyValueRange() &
[since 6.4] auto QMultiHash::asKeyValueRange() const &&
[since 6.4] auto QMultiHash::asKeyValueRange() const &
Devuelve un objeto de rango que permite iterar sobre este hash como pares clave/valor. Por ejemplo, este objeto de rango se puede utilizar en un bucle «for» basado en rangos, en combinación con una declaración de enlace estructurado:
QMultiHash<QString, int> hash;
hash.insert("January", 1);
hash.insert("February", 2);
// ...
hash.insert("December", 12);
for (auto [key, value] : hash.asKeyValueRange()) {
cout << qPrintable(key) << ": " << value << endl;
--value; // convert to JS month indexing
}Ten en cuenta que tanto la clave como el valor obtenidos de esta forma son referencias a los que se encuentran en el hash. Concretamente, modificar el valor alterará el propio hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando el hash sea destruido.
Estas funciones se introdujeron en Qt 6.4.
Véase también QKeyValueIterator.
QMultiHash<Key, T>::iterator QMultiHash::begin()
Devuelve un iterador de tipo STL que apunta al primer elemento del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también constBegin() y end().
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::begin() const
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no constante sobre el hash, o cuando se destruya el hash.
Esta es una función sobrecargada.
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cbegin() const
Devuelve un iterador const al estilo STL que apunta al primer elemento del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const en el hash, o cuando se destruya el hash.
Véase también begin() y cend().
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cend() const
Devuelve un iterador constante al estilo STL que apunta al elemento imaginario situado después del último elemento del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también cbegin() y end().
[noexcept(...)] void QMultiHash::clear()
Elimina todos los elementos del hash y libera toda la memoria que ocupa.
Nota: Esta función es «noexcept» cuando std::is_nothrow_destructible<Node>::value es true.
Véase también ` remove()`.
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constBegin() const
Devuelve un iterador const al estilo STL que apunta al primer elemento del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando el hash se destruya.
Véase también begin() y constEnd().
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constEnd() const
Devuelve un iterador const al estilo STL que apunta al elemento imaginario situado después del último elemento del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también constBegin() y end().
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constFind(const Key &key, const T &value) const
Devuelve un iterador que apunta al elemento del hash que contiene « key » y « value ».
Si el hash no contiene dicho elemento, la función devuelve ` constEnd()`.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueBegin() const
Devuelve un iterador const al estilo STL que apunta a la primera entrada del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también ` keyValueBegin()`.
[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueEnd() const
Devuelve un iterador const al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también ` constKeyValueBegin()`.
[noexcept] bool QMultiHash::contains(const Key &key, const T &value) const
Devuelve « true » si el hash contiene un elemento con las claves « key » y « value »; en caso contrario, devuelve « false ».
Véase también count().
[noexcept] qsizetype QMultiHash::count(const Key &key, const T &value) const
Devuelve el número de elementos que cumplen las condiciones key y value.
Véase también contains().
template <typename... Args> QMultiHash<Key, T>::iterator QMultiHash::emplace(Key &&key, Args &&... args)
template <typename... Args> QMultiHash<Key, T>::iterator QMultiHash::emplace(const Key &key, Args &&... args)
Inserta un nuevo elemento en el contenedor. Este nuevo elemento se crea in situ utilizando ` args ` como argumentos para su creación.
Si ya existe un elemento con la misma clave en el hash, esta función simplemente creará uno nuevo. (Este comportamiento difiere del de ` replace()`, que sobrescribe el valor de un elemento existente).
Devuelve un iterador que apunta al nuevo elemento.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también ` insert`.
template <typename... Args> QMultiHash<Key, T>::iterator QMultiHash::emplaceReplace(Key &&key, Args &&... args)
template <typename... Args> QMultiHash<Key, T>::iterator QMultiHash::emplaceReplace(const Key &key, Args &&... args)
Inserta un nuevo elemento en el contenedor. Este nuevo elemento se crea in situ utilizando args como argumentos para su creación.
Si ya existe un elemento con la misma clave en el hash, el valor de ese elemento se sustituye por un valor construido a partir de ` args`.
Devuelve un iterador que apunta al nuevo elemento.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando el hash sea destruido.
Véase también replace y emplace.
[noexcept] QMultiHash<Key, T>::iterator QMultiHash::end()
Devuelve un iterador de estilo STL que apunta al elemento imaginario situado después del último elemento del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también begin() y constEnd().
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::end() const
Esta es una función sobrecargada.
std::pair<QMultiHash<Key, T>::iterator, QMultiHash<Key, T>::iterator> QMultiHash::equal_range(const Key &key)
Devuelve un par de iteradores que delimitan el rango de valores [first, second), almacenados en key. Si el rango está vacío, ambos iteradores serán iguales a end().
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
[noexcept] std::pair<QMultiHash<Key, T>::const_iterator, QMultiHash<Key, T>::const_iterator> QMultiHash::equal_range(const Key &key) const
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Esta es una función sobrecargada.
QMultiHash<Key, T>::iterator QMultiHash::erase(QMultiHash<Key, T>::const_iterator pos)
Elimina del hash el par (clave, valor) asociado al iterador pos y devuelve un iterador al siguiente elemento del hash.
Esta función nunca provoca que QMultiHash reorganice su estructura de datos interna. Esto significa que se puede invocar de forma segura durante la iteración y no afectará al orden de los elementos del hash. Por ejemplo:
QMultiHash<QObject *, int> objectHash;
//...
QMultiHash<QObject *, int>::iterator i = objectHash.find(obj);
while (i != objectHash.end() && i.key() == obj) {
if (i.value() == 0) {
i = objectHash.erase(i);
} else {
++i;
}
}Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando el hash se destruya.
Véase también remove(), take() y find().
QMultiHash<Key, T>::iterator QMultiHash::find(const Key &key, const T &value)
Devuelve un iterador que apunta al elemento con los valores « key » y « value ». Si el hash no contiene ningún elemento con esos valores, la función devuelve « end()».
Si el hash contiene varios elementos con los valores key y value, el iterador devuelto apunta al elemento insertado más recientemente.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::find(const Key &key, const T &value) const
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Esta es una función sobrecargada.
QMultiHash<Key, T>::iterator QMultiHash::insert(const Key &key, const T &value)
Inserta un nuevo elemento con la clave « key » y el valor « value ».
Si ya existe un elemento con la misma clave en el hash, esta función simplemente creará uno nuevo. (Este comportamiento difiere del de replace(), que sobrescribe el valor de un elemento existente).
QMultiHash Permite claves duplicadas. Al insertar una clave que ya existe, se añade otra entrada en lugar de sobrescribirla. No se garantiza el orden de los elementos en QMultHash.
Devuelve un iterador que apunta al nuevo elemento.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const en el hash, o cuando se destruya el hash.
Véase también replace().
[since 6.11] QMultiHash<Key, T>::iterator QMultiHash::insert(Key &&key, T &&value)
[since 6.11] QMultiHash<Key, T>::iterator QMultiHash::insert(Key &&key, const T &value)
[since 6.11] QMultiHash<Key, T>::iterator QMultiHash::insert(const Key &key, T &&value)
Estas funciones se introdujeron en Qt 6.11.
[noexcept] Key QMultiHash::key(const T &value) const
[noexcept] Key QMultiHash::key(const T &value, const Key &defaultKey) const
Devuelve la primera clave asociada a value. Si el hash no contiene ningún elemento asociado a value, devuelve defaultKey, o una clave construida por defecto si no se ha proporcionado este parámetro.
Esta función puede ser lenta (tiempo lineal), ya que la estructura de datos interna de QMultiHash está optimizada para una búsqueda rápida por clave, no por valor.
[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyBegin() const
Devuelve un iterador const al estilo STL que apunta a la primera clave del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también keyEnd().
[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyEnd() const
Devuelve un iterador const al estilo STL que apunta al elemento imaginario situado después de la última clave del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también ` keyBegin()`.
[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueBegin()
Devuelve un iterador de estilo STL que apunta a la primera entrada del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const en el hash, o cuando se destruya el hash.
Véase también ` keyValueEnd()`.
[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueBegin() const
Devuelve un iterador const al estilo STL que apunta a la primera entrada del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también ` keyValueEnd()`.
[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueEnd()
Devuelve un iterador de estilo STL que apunta a la entrada imaginaria situada después de la última entrada del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también keyValueBegin().
[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueEnd() const
Devuelve un iterador const al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del hash.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también ` keyValueBegin()`.
QList<Key> QMultiHash::keys() const
Devuelve una lista que contiene todas las claves del hash, en un orden arbitrario. Las claves que aparecen varias veces en el hash también aparecen varias veces en la lista.
Se garantiza que el orden es el mismo que el utilizado por values().
Esta función crea una nueva lista en tiempo lineal. El consumo de tiempo y memoria que ello conlleva puede evitarse iterando desde keyBegin() a keyEnd().
Véanse también values() y key().
qsizetype QMultiHash::remove(const Key &key)
Elimina del hash todos los elementos que tengan la clave « key ». Devuelve el número de elementos eliminados.
Véase también remove(const Key &key, const T &value).
qsizetype QMultiHash::remove(const Key &key, const T &value)
Elimina del hash todos los elementos que tengan la clave « key » y el valor « value ». Devuelve el número de elementos eliminados.
Véase también remove().
[since 6.1] template <typename Predicate> qsizetype QMultiHash::removeIf(Predicate pred)
Elimina del multi-hash todos los elementos para los que el predicado pred devuelve «true».
La función admite predicados que aceptan un argumento de tipo « QMultiHash<Key, T>::iterator » o un argumento de tipo « std::pair<const Key &, T &> ».
Devuelve el número de elementos eliminados, si los hay.
Esta función se introdujo en Qt 6.1.
Véase también ` clear()` y ` take()`.
QMultiHash<Key, T>::iterator QMultiHash::replace(const Key &key, const T &value)
Inserta un nuevo elemento con el key y un valor de value.
Si ya existe un elemento con el key, el valor de dicho elemento se sustituye por value.
Si hay varios elementos con el key, el valor del elemento insertado más recientemente se sustituye por value.
Devuelve un iterador que apunta al elemento nuevo o actualizado.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando se destruya el hash.
Véase también insert().
[noexcept] void QMultiHash::swap(QMultiHash<Key, T> &other)
Intercambia este multi-hash con other. Esta operación es muy rápida y nunca falla.
T QMultiHash::take(const Key &key)
Elimina del hash el elemento con la clave « key » y devuelve el valor asociado a él.
Si el elemento no existe en el hash, la función simplemente devuelve un valor construido por defecto. Si hay varios elementos con el key en el hash, solo se elimina el que se haya insertado más recientemente.
Si no se utiliza el valor devuelto, la función ` remove()` resulta más eficiente.
Véase también ` remove()`.
QList<Key> QMultiHash::uniqueKeys() const
Devuelve una lista que contiene todas las claves del mapa. Las claves que aparecen varias veces en el mapa solo aparecen una vez en la lista devuelta.
Véanse también keys() y values().
[since 6.0] QMultiHash<Key, T> &QMultiHash::unite(const QHash<Key, T> &other)
Inserta todos los elementos del hash « other » en este hash y devuelve una referencia a este hash.
Esta función se introdujo en Qt 6.0.
Véase también insert().
QMultiHash<Key, T> &QMultiHash::unite(const QMultiHash<Key, T> &other)
Inserta todos los elementos del hash other en este hash y devuelve una referencia a este hash.
Véase también insert().
[noexcept] T QMultiHash::value(const Key &key) const
[noexcept] T QMultiHash::value(const Key &key, const T &defaultValue) const
Devuelve el valor asociado a la clave « key ».
Si el hash no contiene ningún elemento con el identificador ` key`, la función devuelve ` defaultValue` o un valor construido por defecto si no se ha proporcionado este parámetro.
Si hay varios elementos para ` key ` en el hash, se devuelve el valor del último insertado.
QList<T> QMultiHash::values() const
Devuelve una lista que contiene todos los valores del hash, en un orden arbitrario. Si una clave está asociada a varios valores, todos ellos aparecerán en la lista, y no solo el que se haya insertado más recientemente.
Se garantiza que el orden será el mismo que el utilizado por keys().
Esta función crea una nueva lista en tiempo lineal. El consumo de tiempo y memoria que esto conlleva puede evitarse iterando desde ` keyValueBegin()` hasta ` keyValueEnd()`.
Véanse también keys() y value().
QList<T> QMultiHash::values(const Key &key) const
Devuelve una lista con todos los valores asociados a ` key`, ordenados de más reciente a menos reciente.
Esta es una función sobrecargada.
Véase también ` count()` y ` insert()`.
QMultiHash<Key, T> QMultiHash::operator+(const QMultiHash<Key, T> &other) const
Devuelve un hash que contiene todos los elementos de este hash, además de todos los elementos de other. Si una clave es común a ambos hashes, el hash resultante contendrá dicha clave varias veces.
Véase también operator+=().
QMultiHash<Key, T> &QMultiHash::operator+=(const QMultiHash<Key, T> &other)
Inserta todos los elementos del hash other en este hash y devuelve una referencia a este hash.
Véase también unite() y insert().
T &QMultiHash::operator[](const Key &key)
Devuelve el valor asociado a ` key ` como una referencia modificable.
Si el hash no contiene ningún elemento con el key, la función inserta en el hash un valor construido por defecto con el key y devuelve una referencia al mismo.
Si el hash contiene varios elementos con el key, esta función devuelve una referencia al valor insertado más recientemente.
Advertencia: Los iteradores o referenciasdevueltos deben considerarse invalidados la próxima vez que se llame a una función no const sobre el hash, o cuando el hash sea destruido.
Elementos no miembros relacionados
[since 6.1] template <
typename Key,
typename T,
typename Predicate
>
qsizetype erase_if(QMultiHash<Key, T> &hash, Predicate pred)
Elimina todos los elementos para los que el predicado pred devuelve «true» del multi-hash hash.
La función admite predicados que toman como argumento un valor de tipo QMultiHash<Key, T>::iterator o un valor de tipo std::pair<const Key &, T &>.
Devuelve el número de elementos eliminados, si los hay.
Esta función se introdujo en Qt 6.1.
[noexcept(...)] template <typename Key, typename T> size_t qHash(const QMultiHash<Key, T> &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
Los tipos Key y T deben ser compatibles con qHash().
Nota: Esta función es «noexcept» cuando noexcept(qHash(std::declval<Key&>())) && noexcept(qHash(std::declval<T&>())) es true.
[noexcept] bool operator!=(const QMultiHash<Key, T> &lhs, const QMultiHash<Key, T> &rhs)
Devuelve « true » si el multihash de « lhs » no es igual al multihash de « rhs »; en caso contrario, devuelve « false ».
Se considera que dos multihashes son iguales si contienen los mismos pares (clave, valor).
Esta función requiere que el tipo de valor implemente operator==().
Véase también operator==().
template <typename Key, typename T> QDataStream &operator<<(QDataStream &out, const QMultiHash<Key, T> &hash)
Escribe el hash hash en el flujo out.
Esta función requiere que los tipos de clave y valor implementen operator<<().
Véase también «Serialización detipos de datos de Qt».
[noexcept] bool operator==(const QMultiHash<Key, T> &lhs, const QMultiHash<Key, T> &rhs)
Devuelve « true » si el multihash de « lhs » es igual al multihash de « rhs »; en caso contrario, devuelve « false ».
Se considera que dos multihashes son iguales si contienen los mismos pares (clave, valor).
Esta función requiere que el tipo de valor implemente operator==().
Véase también operator!=().
template <typename Key, typename T> QDataStream &operator>>(QDataStream &in, QMultiHash<Key, T> &hash)
Lee un hash del flujo « in » y lo almacena en « hash ».
Esta función requiere que los tipos de clave y valor implementen operator>>().
Véase también «Serialización detipos de datos de Qt».
© 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.