QMultiHash Class

Documentación de funciones miembro

[noexcept] QMultiHash::QMultiHash()

Construye un hash vacío.

[explicit] QMultiHash::QMultiHash(const QHash<Key, T> &other)

Construye una copia de other (que puede ser un QHash o un QMultiHash).

QMultiHash::QMultiHash(std::initializer_list<std::pair<Key, T>> list)

Construye un multi-hash con una copia de cada uno de los elementos de la lista inicializadora list.

template <typename InputIterator> QMultiHash::QMultiHash(InputIterator begin, InputIterator end)

Construye un multi-hash con una copia de cada uno de los elementos en el rango del iterador [begin, end). O bien los elementos iterados por el rango deben ser objetos con miembros de datos first y second (como std::pair), convertibles a Key y a T respectivamente; o bien los iteradores deben tener funciones miembro key() y value(), devolviendo una clave convertible a Key y un valor convertible a T respectivamente.

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 estructurada:

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
}

Tenga en cuenta que tanto la clave como el valor obtenidos de esta forma son referencias a los del hash. Específicamente, al mutar el valor se modificará el propio hash.

Estas funciones se introdujeron en Qt 6.4.

Véase también QKeyValueIterator.

QMultiHash<Key, T>::iterator QMultiHash::begin()

Devuelve un iterador de estilo STL que apunta al primer elemento del hash.

Véase también constBegin() y end().

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::begin() const

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cbegin() const

Devuelve un iterador const de estilo STL que apunta al primer elemento del hash.

Véase también begin() y cend().

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cend() const

Devuelve un iterador const de estilo STL que apunta al elemento imaginario después del último elemento del hash.

Véase también cbegin() y end().

[noexcept(...)] void QMultiHash::clear()

Elimina todos los elementos del hash y libera toda la memoria utilizada por él.

Véase también remove().

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constBegin() const

Devuelve un iterador const de estilo STL que apunta al primer elemento del hash.

Véase también begin() y constEnd().

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constEnd() const

Devuelve un iterador const de estilo STL que apunta al elemento imaginario después del último elemento del 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 con key y value en el hash.

Si el hash no contiene dicho elemento, la función devuelve constEnd().

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueBegin() const

Devuelve un iterador const de estilo STL que apunta a la primera entrada del hash.

Véase también keyValueBegin().

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueEnd() const

Devuelve un iterador const de estilo STL que apunta a la entrada imaginaria después de la última entrada del 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 los valores 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 con las etiquetas key y value.

Véase también contains().

Inserta un nuevo elemento en el contenedor. Este nuevo elemento se construye in situ utilizando args como argumentos para su construcción.

Si ya existe un elemento con la misma clave en el hash, esta función simplemente creará uno nuevo. (Este comportamiento es diferente de replace(), que sobrescribe el valor de un elemento existente).

Devuelve un iterador que apunta al nuevo elemento.

Véase también insert.

Inserta un nuevo elemento en el contenedor. Este nuevo elemento se construye in situ utilizando args como argumentos para su construcció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.

Véase también replace y emplace.

[noexcept] QMultiHash<Key, T>::iterator QMultiHash::end()

Devuelve un iterador estilo STL que apunta al elemento imaginario después del último elemento del hash.

Véase también begin() y constEnd().

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::end() const

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), que se almacenan bajo key. Si el rango está vacío entonces ambos iteradores serán iguales a end().

[noexcept] std::pair<QMultiHash<Key, T>::const_iterator, QMultiHash<Key, T>::const_iterator> QMultiHash::equal_range(const Key &key) const

QMultiHash<Key, T>::iterator QMultiHash::erase(QMultiHash<Key, T>::const_iterator pos)

Elimina el par (clave, valor) asociado con el iterador pos del hash, y devuelve un iterador al siguiente elemento del hash.

Esta función nunca hace que QMultiHash rehaga su estructura de datos interna. Esto significa que puede ser llamada con seguridad mientras se itera, y no afectará al orden de los elementos en el 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;
    }
}

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 key y value. Si el hash no contiene tal elemento, la función devuelve end().

Si el hash contiene múltiples ítems con key y value, el iterador devuelto apunta al ítem insertado más recientemente.

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::find(const Key &key, const T &value) const

QMultiHash<Key, T>::iterator QMultiHash::insert(const Key &key, const T &value)

Inserta un nuevo elemento con la key y un valor de value.

Si ya existe un elemento con la misma clave en el hash, esta función simplemente creará uno nuevo. (Este comportamiento es diferente de replace(), que sobrescribe el valor de un elemento existente).

Devuelve un iterador que apunta al nuevo elemento.

Véase también replace().

Estas funciones se introdujeron en Qt 6.11.

Devuelve la primera clave asignada a value. Si el hash no contiene ningún elemento asignado 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), porque 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 de estilo STL que apunta a la primera clave del hash.

Véase también keyEnd().

[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyEnd() const

Devuelve un iterador const de estilo STL que apunta al elemento imaginario después de la última clave del hash.

Véase también keyBegin().

[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueBegin()

Devuelve un iterador estilo STL que apunta a la primera entrada del hash.

Véase también keyValueEnd().

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueBegin() const

Devuelve un iterador const de estilo STL que apunta a la primera entrada del hash.

Véase también keyValueEnd().

[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueEnd()

Devuelve un iterador estilo STL que apunta a la entrada imaginaria después de la última entrada en el hash.

Véase también keyValueBegin().

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueEnd() const

Devuelve un iterador const de estilo STL que apunta a la entrada imaginaria después de la última entrada del 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 sea el mismo que el utilizado por values().

Esta función crea una nueva lista en tiempo lineal. El tiempo y uso de memoria que conlleva puede evitarse iterando de keyBegin() a keyEnd().

Véase también values() y key().

qsizetype QMultiHash::remove(const Key &key)

Elimina todos los elementos que tienen el key del hash. 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 tienen el 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 verdadero.

La función admite predicados que toman 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 valor key, el valor de ese elemento se sustituye por value.

Si hay varios elementos con key, el valor del elemento insertado más recientemente se sustituye por value.

Devuelve un iterador que apunta al elemento nuevo/actualizado.

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 el elemento con key del hash 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 para key en el hash, sólo se elimina el insertado más recientemente.

Si no se utiliza el valor devuelto, remove() es más eficiente.

Véase también remove().

QList<Key> QMultiHash::uniqueKeys() const

Devuelve una lista con todas las claves del mapa. Las claves que aparecen varias veces en el mapa sólo aparecen una vez en la lista devuelta.

Véase 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().

Devuelve el valor asociado a key.

Si el hash no contiene ningún elemento con el key, la función devuelve defaultValue, o un valor construido por defecto si no se ha suministrado este parámetro.

Si hay varios elementos para el key en el hash, se devuelve el valor del insertado más recientemente.

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 múltiples valores, todos sus valores estarán en la lista, y no sólo el insertado más recientemente.

Se garantiza que el orden sea el mismo que el utilizado por keys().

Esta función crea una nueva lista, en tiempo lineal. El uso de tiempo y memoria que conlleva puede evitarse iterando desde keyValueBegin() hasta keyValueEnd().

Véase también keys() y value().

QList<T> QMultiHash::values(const Key &key) const

Devuelve una lista de todos los valores asociados a key, desde el más reciente hasta el menos reciente.

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á la 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 referencia modificable.

Si el hash no contiene ningún elemento con el key, la función inserta un valor construido por defecto en el hash con el key, y devuelve una referencia al mismo.

Si el hash contiene varios elementos con key, esta función devuelve una referencia al valor insertado más recientemente.

Véase también insert() y value().