QMultiMap Class

Documentación de funciones miembro

QMultiMap::QMultiMap()

Construye un mapa múltiple vacío.

Véase también clear().

[explicit, since 6.0] QMultiMap::QMultiMap(QMap<Key, T> &&other)

Si other es compartido, construye un mapa múltiple como una copia de other. De lo contrario, construye un mapa múltiple moviendo los elementos de other.

Esta función se introdujo en Qt 6.0.

[explicit, since 6.0] QMultiMap::QMultiMap(const QMap<Key, T> &other)

Construye un mapa múltiple como una copia de other.

Esta función se introdujo en Qt 6.0.

[explicit] QMultiMap::QMultiMap(const std::multimap<Key, T> &other)

Construye una copia de other.

Véase también toStdMultiMap().

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

Construye un mapa múltiple con una copia de cada uno de los elementos de la lista inicializadora list.

[explicit] QMultiMap::QMultiMap(std::multimap<Key, T> &&other)

Construye un mapa múltiple desplazándose desde other.

Véase también toStdMultiMap().

[default] QMultiMap::QMultiMap(const QMultiMap<Key, T> &other)

Construye una copia de other.

Esta operación ocurre en tiempo constante, porque QMultiMap es implícitamente compartido. Esto hace que devolver un QMultiMap desde una función sea muy rápido. Si una instancia compartida es modificada, será copiada (copy-on-write), y esto toma tiempo lineal.

Véase también operator=().

[default] QMultiMap::QMultiMap(QMultiMap<Key, T> &&other)

Move-construye una instancia de QMultiMap, haciendo que apunte al mismo objeto al que apuntaba other.

[default] QMultiMap::~QMultiMap()

Destruye el mapa múltiple. Las referencias a los valores del mapa múltiple, y todos los iteradores sobre este mapa múltiple, dejan de ser válidos.

Devuelve un objeto de rango que permite iterar sobre este mapa múltiple como pares clave/valor. Por ejemplo, este objeto range puede utilizarse en un bucle for basado en range, en combinación con una declaración de vinculación estructurada:

QMultiMap<QString, int> map;
map.insert("January", 1);
map.insert("February", 2);
// ...
map.insert("December", 12);

for (auto [key, value] : map.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 mapa múltiple. En concreto, al mutar el valor se modificará el propio mapa.

Estas funciones se introdujeron en Qt 6.4.

Véase también QKeyValueIterator.

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

Devuelve un iterador de estilo STL que apunta al primer elemento del mapa múltiple.

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

QMultiMap<Key, T>::const_iterator QMultiMap::begin() const

QMultiMap<Key, T>::const_iterator QMultiMap::cbegin() const

Devuelve un iterador const de estilo STL que apunta al primer elemento del mapa múltiple.

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

QMultiMap<Key, T>::const_iterator QMultiMap::cend() const

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

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

void QMultiMap::clear()

Elimina todos los elementos del mapa múltiple.

Véase también remove().

QMultiMap<Key, T>::const_iterator QMultiMap::constBegin() const

Devuelve un iterador const de estilo STL que apunta al primer elemento del mapa múltiple.

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

QMultiMap<Key, T>::const_iterator QMultiMap::constEnd() const

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

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

QMultiMap<Key, T>::const_iterator QMultiMap::constFind(const Key &key) const

Devuelve un iterador const que apunta al elemento con clave key en el mapa múltiple.

Si el mapa múltiple no contiene ningún elemento con la clave key, la función devuelve constEnd().

Véase también find() y QMultiMap::constFind(const Key &key, const T &value).

QMultiMap<Key, T>::const_iterator QMultiMap::constFind(const Key &key, const T &value) const

Devuelve un iterador que apunta al elemento con la clave key y el valor value en el mapa.

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

Véase también QMap::constFind().

QMultiMap<Key, T>::const_key_value_iterator QMultiMap::constKeyValueBegin() const

Devuelve un iterador const de estilo STL que apunta a la primera entrada del mapa múltiple.

Véase también keyValueBegin().

QMultiMap<Key, T>::const_key_value_iterator QMultiMap::constKeyValueEnd() const

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

Véase también constKeyValueBegin().

bool QMultiMap::contains(const Key &key) const

Devuelve true si el mapa múltiple contiene un elemento con la clave key; en caso contrario devuelve false.

Véase también count().

bool QMultiMap::contains(const Key &key, const T &value) const

Devuelve true si el mapa múltiple contiene un elemento con la clave key y el valor value; en caso contrario devuelve false.

Véase también count().

QMultiMap<Key, T>::size_type QMultiMap::count(const Key &key) const

Devuelve el número de elementos asociados a la clave key.

Véase también contains() y QMultiMap::count(const Key &key, const T &value).

QMultiMap<Key, T>::size_type QMultiMap::count(const Key &key, const T &value) const

Devuelve el número de elementos con clave key y valor value.

Véase también contains() y QMultiMap::count().

QMultiMap<Key, T>::size_type QMultiMap::count() const

Igual que size().

bool QMultiMap::empty() const

Esta función se proporciona por compatibilidad con STL. Es equivalente a isEmpty(), devolviendo true si el mapa está vacío; en caso contrario devuelve false.

QMultiMap<Key, T>::iterator QMultiMap::end()

Devuelve un iterador de estilo STL que apunta al elemento imaginario después del último elemento del mapa múltiple.

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

QMultiMap<Key, T>::const_iterator QMultiMap::end() const

std::pair<QMultiMap<Key, T>::iterator, QMultiMap<Key, T>::iterator> QMultiMap::equal_range(const Key &key)

Devuelve un par de iteradores que delimitan el rango de valores [first, second), que se almacenan en key.

std::pair<QMultiMap<Key, T>::const_iterator, QMultiMap<Key, T>::const_iterator> QMultiMap::equal_range(const Key &key) const

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

Elimina el par (clave, valor) apuntado por el iterador pos del mapa múltiple y devuelve un iterador al siguiente elemento del mapa.

Véase también remove().

[since 6.0] QMultiMap<Key, T>::iterator QMultiMap::erase(QMultiMap<Key, T>::const_iterator first, QMultiMap<Key, T>::const_iterator last)

Elimina los pares (clave, valor) señalados por el rango de iteradores [first, last) del mapa múltiple. Devuelve un iterador al elemento del mapa múltiple siguiente al último elemento eliminado.

Esta función se introdujo en Qt 6.0.

Véase también remove().

QMultiMap<Key, T>::iterator QMultiMap::find(const Key &key)

Devuelve un iterador que apunta al elemento con clave key en el mapa múltiple.

Si el mapa múltiple no contiene ningún elemento con la clave key, la función devuelve end().

Si el mapa contiene varios elementos con la clave key, esta función devuelve un iterador que apunta al valor insertado más recientemente. Los demás valores son accesibles incrementando el iterador. Por ejemplo, aquí hay algo de código que itera sobre todos los elementos con la misma clave:

auto i = multimap.find("plenty");
while (i != multimap.end() && i.key() == "plenty") {
    cout << i.value() << endl;
    ++i;
}

// better:
auto [i, end] = multimap.equal_range("plenty");
while (i != end) {
    cout << i.value() << endl;
    ++i;
}

Véase también constFind(), value(), values(), lowerBound(), y upperBound().

QMultiMap<Key, T>::const_iterator QMultiMap::find(const Key &key) const

QMultiMap<Key, T>::const_iterator QMultiMap::find(const Key &key, const T &value) const

Devuelve un iterador constante que apunta al elemento con los valores key y value en el mapa.

Si el mapa no contiene dicho elemento, la función devuelve end().

Si el mapa contiene varios elementos con el key especificado, esta función devuelve un iterador constante que apunta al valor insertado más recientemente.

T &QMultiMap::first()

Devuelve una referencia al primer valor del mapa múltiple, es decir, el valor asignado a la clave más pequeña. Esta función asume que el mapa múltiple no está vacío.

Cuando no se comparte (o se llama a la versión const), se ejecuta en tiempo constante.

Véase también last(), firstKey() y isEmpty().

const T &QMultiMap::first() const

const Key &QMultiMap::firstKey() const

Devuelve una referencia a la clave más pequeña del mapa múltiple. Esta función asume que el mapa múltiple no está vacío.

Se ejecuta en tiempo constante.

Véase también lastKey(), first(), keyBegin() y isEmpty().

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

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

Si ya existe un elemento con la misma clave en el mapa, 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().

QMultiMap<Key, T>::iterator QMultiMap::insert(QMultiMap<Key, T>::const_iterator pos, const Key &key, const T &value)

Inserta un nuevo elemento con la clave key y el valor value y con la sugerencia pos sugiriendo dónde realizar la inserción.

Si se utiliza constBegin() como pista indica que key es menor que cualquier clave del mapa múltiple mientras que constEnd() sugiere que key es (estrictamente) mayor que cualquier clave del mapa múltiple. En caso contrario, la pista debe cumplir la condición (pos - 1).key() < key <= pos.key(). Si la pista pos es incorrecta, se ignora y se realiza una inserción normal.

Si la pista es correcta y el mapa múltiple no está compartido, la inserción se ejecuta en tiempo constante amortizado.

Si ya existe un elemento con la misma clave en el mapa, esta función simplemente creará uno nuevo.

Cuando se crea un mapa múltiple a partir de datos ordenados, insertar primero la clave mayor con constBegin() es más rápido que insertar en orden con constEnd(), ya que constEnd() - 1 (que se necesita para comprobar si la pista es válida) necesita tiempo logarítmico.

Devuelve un iterador que apunta al nuevo elemento.

Nota: Ten cuidado con la pista. Proporcionar un iterador de una instancia compartida anterior puede provocar un fallo, pero también existe el riesgo de que corrompa silenciosamente tanto el mapa múltiple como el mapa múltiple pos.

bool QMultiMap::isEmpty() const

Devuelve true si el mapa múltiple no contiene elementos; en caso contrario devuelve false.

Véase también size().

Key QMultiMap::key(const T &value, const Key &defaultKey = Key()) const

Devuelve la primera clave con valor value, o defaultKey si el mapa múltiple no contiene ningún elemento con valor value. Si no se proporciona defaultKey, la función devuelve una clave construida por defecto.

Esta función puede ser lenta(tiempo lineal), porque la estructura de datos interna de QMultiMap está optimizada para una búsqueda rápida por clave, no por valor.

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

QMultiMap<Key, T>::key_iterator QMultiMap::keyBegin() const

Devuelve un iterador const de estilo STL que apunta a la primera clave del mapa múltiple.

Véase también keyEnd() y firstKey().

QMultiMap<Key, T>::key_iterator QMultiMap::keyEnd() const

Devuelve un iterador const de estilo STL que apunta al elemento imaginario después de la última clave en el mapa múltiple.

Véase también keyBegin() y lastKey().

QMultiMap<Key, T>::key_value_iterator QMultiMap::keyValueBegin()

Devuelve un iterador de estilo STL que apunta a la primera entrada del mapa múltiple.

Véase también keyValueEnd().

QMultiMap<Key, T>::const_key_value_iterator QMultiMap::keyValueBegin() const

Devuelve un iterador const de estilo STL que apunta a la primera entrada del mapa múltiple.

Véase también keyValueEnd().

QMultiMap<Key, T>::key_value_iterator QMultiMap::keyValueEnd()

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

Véase también keyValueBegin().

QMultiMap<Key, T>::const_key_value_iterator QMultiMap::keyValueEnd() const

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

Véase también keyValueBegin().

QList<Key> QMultiMap::keys() const

Devuelve una lista que contiene todas las claves del mapa múltiple en orden ascendente. Las claves que aparecen varias veces en el mapa múltiple 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 uso de tiempo y memoria que conlleva puede evitarse iterando de keyBegin() a keyEnd().

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

QList<Key> QMultiMap::keys(const T &value) const

Devuelve una lista que contiene todas las claves asociadas al valor value en orden ascendente.

Esta función puede ser lenta(tiempo lineal), porque la estructura de datos interna de QMultiMap está optimizada para una búsqueda rápida por clave, no por valor.

T &QMultiMap::last()

Devuelve una referencia al último valor del mapa múltiple, es decir, el valor asignado a la clave mayor. Esta función asume que el mapa no está vacío.

Cuando no se comparte (o se llama a la versión const), se ejecuta en tiempo constante.

Véase también first(), lastKey() y isEmpty().

const T &QMultiMap::last() const

const Key &QMultiMap::lastKey() const

Devuelve una referencia a la clave más grande del mapa múltiple. Esta función asume que el mapa múltiple no está vacío.

Se ejecuta en tiempo constante.

Véase también firstKey(), last(), keyEnd() y isEmpty().

QMultiMap<Key, T>::iterator QMultiMap::lowerBound(const Key &key)

Devuelve un iterador que apunta al primer elemento con clave key en el mapa. Si el mapa no contiene ningún elemento con la clave key, la función devuelve un iterador al elemento más cercano con una clave mayor.

Ejemplo:

QMultiMap<int, QString> multimap;
multimap.insert(1, "one");
multimap.insert(5, "five");
multimap.insert(5, "five (2)");
multimap.insert(10, "ten");

multimap.lowerBound(0);      // returns iterator to (1, "one")
multimap.lowerBound(1);      // returns iterator to (1, "one")
multimap.lowerBound(2);      // returns iterator to (5, "five")
multimap.lowerBound(5);      // returns iterator to (5, "five")
multimap.lowerBound(6);      // returns iterator to (10, "ten")
multimap.lowerBound(10);     // returns iterator to (10, "ten")
multimap.lowerBound(999);    // returns end()

Si el mapa contiene varios elementos con la clave key, esta función devuelve un iterador que apunta al valor insertado más recientemente. Los demás valores son accesibles incrementando el iterador. Por ejemplo, aquí hay un código que itera sobre todos los elementos con la misma clave:

QMap<QString, int> multimap;
//...
QMap<QString, int>::const_iterator i = multimap.lowerBound("HDR");
QMap<QString, int>::const_iterator upperBound = multimap.upperBound("HDR");
while (i != upperBound) {
    cout << i.value() << endl;
    ++i;
}

Véase también upperBound() y find().

QMultiMap<Key, T>::const_iterator QMultiMap::lowerBound(const Key &key) const

QMultiMap<Key, T>::size_type QMultiMap::remove(const Key &key)

Elimina todos los elementos que tienen la clave key del mapa múltiple. Devuelve el número de elementos eliminados.

Véase también clear() y take().

QMultiMap<Key, T>::size_type QMultiMap::remove(const Key &key, const T &value)

Elimina todos los elementos que tienen la clave key y el valor value del mapa múltiple. Devuelve el número de elementos eliminados.

Véase también clear() y take().

[since 6.1] template <typename Predicate> QMultiMap<Key, T>::size_type QMultiMap::removeIf(Predicate pred)

Elimina del mapa múltiple todos los elementos para los que el predicado pred devuelve verdadero.

La función admite predicados que toman un argumento de tipo QMultiMap<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().

QMultiMap<Key, T>::iterator QMultiMap::replace(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 clave key, el valor de ese elemento se sustituye por value.

Si hay varios elementos con la clave 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().

QMultiMap<Key, T>::size_type QMultiMap::size() const

Devuelve el número de pares (clave, valor) en el mapa múltiple.

Véase también isEmpty() y count().

[noexcept] void QMultiMap::swap(QMultiMap<Key, T> &other)

Intercambia este mapa múltiple con other. Esta operación es muy rápida y nunca falla.

T QMultiMap::take(const Key &key)

Elimina el elemento con la clave key del mapa múltiple y devuelve el valor asociado a él.

Si el elemento no existe en el mapa múltiple, la función simplemente devuelve un valor construido por defecto. Si hay varios elementos para key en el mapa, sólo se elimina y devuelve el último que se haya insertado.

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

Véase también remove().

std::multimap<Key, T> QMultiMap::toStdMultiMap() const &

Devuelve un mapa STL multi equivalente a este QMultiMap.

QList<Key> QMultiMap::uniqueKeys() const

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

QMultiMap<Key, T> &QMultiMap::unite(QMultiMap<Key, T> &&other)

Mueve todos los elementos del mapa other a este mapa. Si una clave es común a ambos mapas, el mapa resultante contendrá la clave varias veces.

Si other es compartido, los elementos se copiarán en su lugar.

QMultiMap<Key, T> &QMultiMap::unite(const QMultiMap<Key, T> &other)

Inserta todos los elementos del mapa other en este mapa. Si una clave es común a ambos mapas, el mapa resultante contendrá la clave varias veces.

QMultiMap<Key, T>::iterator QMultiMap::upperBound(const Key &key)

Devuelve un iterador que apunta al elemento que sigue inmediatamente al último elemento con clave key en el mapa. Si el mapa no contiene ningún elemento con la clave key, la función devuelve un iterador al elemento más cercano con una clave mayor.

Ejemplo:

QMultiMap<int, QString> multimap;
multimap.insert(1, "one");
multimap.insert(5, "five");
multimap.insert(5, "five (2)");
multimap.insert(10, "ten");

multimap.upperBound(0);      // returns iterator to (1, "one")
multimap.upperBound(1);      // returns iterator to (5, "five")
multimap.upperBound(2);      // returns iterator to (5, "five")
multimap.lowerBound(5);      // returns iterator to (5, "five (2)")
multimap.lowerBound(6);      // returns iterator to (10, "ten")
multimap.upperBound(10);     // returns end()
multimap.upperBound(999);    // returns end()

Véase también lowerBound() y find().

QMultiMap<Key, T>::const_iterator QMultiMap::upperBound(const Key &key) const

T QMultiMap::value(const Key &key, const T &defaultValue = T()) const

Devuelve el valor asociado a la clave key.

Si el mapa múltiple no contiene ningún elemento con la clave key, la función devuelve defaultValue. Si no se especifica defaultValue, la función devuelve un valor construido por defecto. Si hay varios elementos para key en el mapa múltiple, se devuelve el valor del insertado más recientemente.

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

QList<T> QMultiMap::values() const

Devuelve una lista que contiene todos los valores del mapa, en orden ascendente de sus claves. 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.

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

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

Devuelve una lista que contiene todos los valores asociados a la clave key, desde el insertado más recientemente hasta el insertado menos recientemente.

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

[default] QMultiMap<Key, T> &QMultiMap::operator=(QMultiMap<Key, T> &&other)

Mover-asigna other a esta instancia QMultiMap.

[default] QMultiMap<Key, T> &QMultiMap::operator=(const QMultiMap<Key, T> &other)

Asigna other a este mapa múltiple y devuelve una referencia a este mapa múltiple.