En esta página

QMap Class

template <typename Key, typename T> class QMap

La clase QMap es una clase de plantilla que proporciona una matriz asociativa. Más información...

Encabezado: #include <QMap>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QMap

CategoríaTipos comparables
igualdadQMap

Tipos públicos

Funciones públicas

QMap()
QMap(const std::map<Key, T> &other)
QMap(std::initializer_list<std::pair<Key, T>> list)
QMap(std::map<Key, T> &&other)
QMap(const QMap<Key, T> &other)
QMap(QMap<Key, T> &&other)
~QMap()
(since 6.4) auto asKeyValueRange() &&
(since 6.4) auto asKeyValueRange() &
(since 6.4) auto asKeyValueRange() const &&
(since 6.4) auto asKeyValueRange() const &
QMap<Key, T>::iterator begin()
QMap<Key, T>::const_iterator begin() const
QMap<Key, T>::const_iterator cbegin() const
QMap<Key, T>::const_iterator cend() const
void clear()
QMap<Key, T>::const_iterator constBegin() const
QMap<Key, T>::const_iterator constEnd() const
QMap<Key, T>::const_iterator constFind(const Key &key) const
QMap<Key, T>::const_key_value_iterator constKeyValueBegin() const
QMap<Key, T>::const_key_value_iterator constKeyValueEnd() const
bool contains(const Key &key) const
QMap<Key, T>::size_type count(const Key &key) const
QMap<Key, T>::size_type count() const
bool empty() const
QMap<Key, T>::iterator end()
QMap<Key, T>::const_iterator end() const
std::pair<QMap<Key, T>::iterator, QMap<Key, T>::iterator> equal_range(const Key &key)
std::pair<QMap<Key, T>::const_iterator, QMap<Key, T>::const_iterator> equal_range(const Key &key) const
QMap<Key, T>::iterator erase(QMap<Key, T>::const_iterator pos)
(since 6.0) QMap<Key, T>::iterator erase(QMap<Key, T>::const_iterator first, QMap<Key, T>::const_iterator last)
QMap<Key, T>::iterator find(const Key &key)
QMap<Key, T>::const_iterator find(const Key &key) const
T &first()
const T &first() const
const Key &firstKey() const
void insert(QMap<Key, T> &&map)
void insert(const QMap<Key, T> &map)
QMap<Key, T>::iterator insert(const Key &key, const T &value)
QMap<Key, T>::iterator insert(QMap<Key, T>::const_iterator pos, const Key &key, const T &value)
bool isEmpty() const
Key key(const T &value, const Key &defaultKey = Key()) const
QMap<Key, T>::key_iterator keyBegin() const
QMap<Key, T>::key_iterator keyEnd() const
QMap<Key, T>::key_value_iterator keyValueBegin()
QMap<Key, T>::const_key_value_iterator keyValueBegin() const
QMap<Key, T>::key_value_iterator keyValueEnd()
QMap<Key, T>::const_key_value_iterator keyValueEnd() const
QList<Key> keys() const
QList<Key> keys(const T &value) const
T &last()
const T &last() const
const Key &lastKey() const
QMap<Key, T>::iterator lowerBound(const Key &key)
QMap<Key, T>::const_iterator lowerBound(const Key &key) const
QMap<Key, T>::size_type remove(const Key &key)
(since 6.1) QMap<Key, T>::size_type removeIf(Predicate pred)
QMap<Key, T>::size_type size() const
void swap(QMap<Key, T> &other)
T take(const Key &key)
std::map<Key, T> toStdMap() const &
(since 6.0) std::map<Key, T> toStdMap() &&
QMap<Key, T>::iterator upperBound(const Key &key)
QMap<Key, T>::const_iterator upperBound(const Key &key) const
T value(const Key &key, const T &defaultValue = T()) const
QList<T> values() const
QMap<Key, T> &operator=(QMap<Key, T> &&other)
QMap<Key, T> &operator=(const QMap<Key, T> &other)
T &operator[](const Key &key)
T operator[](const Key &key) const
(since 6.1) qsizetype erase_if(QMap<Key, T> &map, Predicate pred)
(since 6.8) size_t qHash(const QMap<Key, T> &key, size_t seed = 0)
bool operator!=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) bool operator<(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
QDataStream &operator<<(QDataStream &out, const QMap<Key, T> &map)
(since 6.12) bool operator<=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) auto operator<=>(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
bool operator==(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) bool operator>(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) bool operator>=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
QDataStream &operator>>(QDataStream &in, QMap<Key, T> &map)

Descripción detallada

QMap<KEY, T> es una de las clases de contenedores genéricos de Qt, en la que Key es el tipo utilizado para las claves de búsqueda y T es el tipo de valor asignado. Almacena pares (clave, valor) y permite una búsqueda rápida por clave.

QMap y QHash ofrecen una funcionalidad muy similar. Las diferencias son:

  • QHash ofrece búsquedas, en promedio, más rápidas que QMap. (Véase «Complejidad algorítmica» para más detalles.)
  • Al iterar sobre un ` QHash`, los elementos se ordenan de forma arbitraria. Con `QMap`, los elementos siempre se ordenan por clave.
  • El tipo de clave de un ` QHash ` debe proporcionar el operador `==()` y una función global ` qHash(Key)`. El tipo de clave de un `QMap` debe proporcionar el operador `<()`, especificando un orden total. Desde Qt 5.8.1, también es seguro utilizar un tipo de puntero como clave, incluso si el operador `<()` subyacente no proporciona un orden total.

A continuación se muestra un ejemplo de QMap con claves de tipo « QString » y valores de tipo « int »:

QMap<QString, int> map;

Para insertar un par (clave, valor) en el mapa, puedes utilizar el operador []():

map["one"] = 1;
map["three"] = 3;
map["seven"] = 7;

Esto inserta los siguientes tres pares (clave, valor) en el QMap: («one», 1), («three», 3) y («seven», 7). Otra forma de insertar elementos en el mapa es utilizar insert():

map.insert("twelve", 12);

Para buscar un valor, utiliza el operador []() o value():

int num1 = map["thirteen"];
int num2 = map.value("thirteen");

Si no hay ningún elemento con la clave especificada en el mapa, estas funciones devuelven un valor construido por defecto.

Si quieres comprobar si el mapa contiene una clave determinada, utiliza contains():

int timeout = 30;
if (map.contains("TIMEOUT"))
    timeout = map.value("TIMEOUT");

También existe una sobrecarga de ` value()` que utiliza su segundo argumento como valor por defecto si no hay ningún elemento con la clave especificada:

int timeout = map.value("TIMEOUT", 30);

En general, recomendamos utilizar ` contains()` y ` value()` en lugar del operador `[]()` para buscar una clave en un mapa. El motivo es que el operador []() inserta silenciosamente un elemento en el mapa si no existe ningún elemento con la misma clave (a menos que el mapa sea const). Por ejemplo, el siguiente fragmento de código creará 1000 elementos en memoria:

// WRONG
QMap<int, QWidget *> map;
//...
for (int i = 0; i < 1000; ++i) {
    if (map[i] == okButton)
        cout << "Found button at index " << i << endl;
}

Para evitar este problema, sustituye map[i] por map.value(i) en el código anterior.

Si quieres recorrer todos los pares (clave, valor) almacenados en un QMap, puedes utilizar un iterador. QMap proporciona tanto iteradores al estilo Java (QMapIterator y QMutableMapIterator) como iteradores al estilo STL (QMap::const_iterator y QMap::iterator). A continuación se muestra cómo iterar sobre un QMap<QString, int> utilizando un iterador al estilo Java:

QMapIterator<QString, int> i(map);
while (i.hasNext()) {
    i.next();
    cout << qPrintable(i.key()) << ": " << i.value() << endl;
}

Este es el mismo código, pero esta vez utilizando un iterador de estilo STL:

for (auto i = map.cbegin(), end = map.cend(); i != end; ++i)
    cout << qPrintable(i.key()) << ": " << i.value() << endl;

Los elementos se recorren en orden ascendente por clave.

Un QMap solo permite un valor por clave. Si llamas a insert() con una clave que ya existe en el QMap, se borrará el valor anterior. Por ejemplo:

map.insert("plenty", 100);
map.insert("plenty", 2000);
// map.value("plenty") == 2000

Sin embargo, puedes almacenar varios valores por clave utilizando ` QMultiMap`.

Si solo necesitas extraer los valores de un mapa (no las claves), también puedes utilizar un bucle «for» basado en un rango:

QMap<QString, int> map;
//...
for (int value : std::as_const(map))
    cout << value << endl;

Los elementos se pueden eliminar del mapa de varias formas. Una de ellas es llamar a ` remove()`; esto eliminará cualquier elemento con la clave indicada. Otra forma es utilizar ` QMutableMapIterator::remove()`. Además, puedes borrar todo el mapa utilizando ` clear()`.

Los tipos de datos de clave y valor de QMap deben ser tipos de datos asignables. Esto abarca la mayoría de los tipos de datos con los que probablemente te encontrarás, pero el compilador no te permitirá, por ejemplo, almacenar un ` QWidget ` como valor; en su lugar, debes almacenar un ` QWidget *`. Además, el tipo de clave de QMap debe proporcionar el operador `<()`. QMap lo utiliza para mantener sus elementos ordenados, y asume que dos claves ` x ` y ` y ` son equivalentes si ni ` x < y ` ni ` y < x ` son verdaderos.

Ejemplo:

#ifndef EMPLOYEE_H
#define EMPLOYEE_H

class Employee
{
public:
    Employee() {}
    Employee(const QString &name, QDate dateOfBirth);
    QString name() const { return myName; }
    QDate dateOfBirth() const { return myDateOfBirth; }
    //...

private:
    QString myName;
    QDate myDateOfBirth;
};

inline bool operator<(const Employee &e1, const Employee &e2)
{
    if (e1.name() != e2.name())
        return e1.name() < e2.name();
    return e1.dateOfBirth() < e2.dateOfBirth();
}

#endif // EMPLOYEE_H

En el ejemplo, empezamos comparando los nombres de los empleados. Si son iguales, comparamos sus fechas de nacimiento para desempatar.

Véase también QMapIterator, QMutableMapIterator, QHash y QSet.

Documentación sobre tipos de miembros

QMap::ConstIterator

Sinónimo al estilo Qt de « QMap::const_iterator ».

QMap::Iterator

Sinónimo al estilo Qt de « QMap::iterator ».

QMap::const_key_value_iterator

La definición de tipo `QMap::const_key_value_iterator` proporciona un iterador al estilo de la STL para ` QMap`.

QMap::const_key_value_iterator es, en esencia, igual que ` QMap::const_iterator `, con la diferencia de que el operador `*()` devuelve un par clave/valor en lugar de un valor.

Véase también QKeyValueIterator.

[alias] QMap::difference_type

Definición de tipo para ptrdiff_t. Se proporciona para garantizar la compatibilidad con la STL.

[alias] QMap::key_type

Definición de tipo para «Key». Se proporciona para garantizar la compatibilidad con la STL.

QMap::key_value_iterator

La definición de tipo `QMap::key_value_iterator` proporciona un iterador al estilo STL para ` QMap`.

QMap::key_value_iterator es esencialmente igual que QMap::iterator, con la diferencia de que el operador *() devuelve un par clave/valor en lugar de un valor.

Véase también QKeyValueIterator.

[alias] QMap::mapped_type

Definición de tipo para T. Se proporciona para garantizar la compatibilidad con la STL.

[alias] QMap::size_type

Definición de tipo para `int`. Se proporciona para garantizar la compatibilidad con la STL.

Documentación de las funciones miembro

[default] QMap::QMap()

Crea un mapa vacío.

Véase también clear().

[explicit] QMap::QMap(const std::map<Key, T> &other)

Crea una copia de other.

Véase también toStdMap().

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

Crea un mapa con una copia de cada uno de los elementos de la lista de inicialización list.

[explicit] QMap::QMap(std::map<Key, T> &&other)

Crea un mapa a partir de other.

Véase también toStdMap().

[implicit] QMap::QMap(const QMap<Key, T> &other)

Crea una copia de ` other`.

Esta operación se realiza en tiempo constante, ya que QMap se comparte de forma implícita. Esto hace que devolver un QMap desde una función sea muy rápido. Si se modifica una instancia compartida, se copiará (copia al escribir), lo que lleva un tiempo lineal.

Véase también operator=.

[implicit] QMap::QMap(QMap<Key, T> &&other)

Crea una instancia de QMap mediante la construcción «move».

[implicit] QMap::~QMap()

Destruye el mapa. Las referencias a los valores del mapa, así como todos los iteradores sobre este mapa, dejan de ser válidas.

[since 6.4] auto QMap::asKeyValueRange() &&

[since 6.4] auto QMap::asKeyValueRange() &

[since 6.4] auto QMap::asKeyValueRange() const &&

[since 6.4] auto QMap::asKeyValueRange() const &

Devuelve un objeto de rango que permite iterar por este mapa 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:

QMap<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
}

Ten en cuenta que tanto la clave como el valor obtenidos de esta forma son referencias a los que se encuentran en el mapa. En concreto, modificar el valor alterará el propio mapa.

Estas funciones se introdujeron en Qt 6.4.

Véase también QKeyValueIterator.

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

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

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

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

Esta es una función sobrecargada.

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

Devuelve un iterador constante al estilo STL que apunta al primer elemento del mapa.

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

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

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

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

void QMap::clear()

Elimina todos los elementos del mapa.

Véase también remove().

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

Devuelve un iterador constante al estilo STL que apunta al primer elemento del mapa.

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

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

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

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

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

Devuelve un iterador const que apunta al elemento con la clave « key » en el mapa.

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

Véase también ` find()`.

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

Devuelve un iterador constante al estilo STL que apunta a la primera entrada del mapa.

Véase también ` keyValueBegin()`.

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

Devuelve un iterador const al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del mapa.

Véase también ` constKeyValueBegin()`.

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

Devuelve ` true ` si el mapa contiene un elemento con la clave ` key`; en caso contrario, devuelve ` false`.

Véase también count().

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

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

Véase también contains().

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

Es lo mismo que ` size()`.

Esta es una función sobrecargada.

bool QMap::empty() const

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

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

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

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

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

Esta es una función sobrecargada.

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

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

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

Esta es una función sobrecargada.

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

Elimina del mapa el par (clave, valor) al que apunta el iterador pos y devuelve un iterador al siguiente elemento del mapa.

Nota: El iterador pos debe ser válido y poder desreferenciarse.

Véase también remove().

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

Elimina del mapa los pares (clave, valor) a los que apunta el rango del iterador [first, last). Devuelve un iterador al elemento del mapa que sigue al último elemento eliminado.

Nota: El rango [first, last) debe ser un rango válido en *this.

Esta función se introdujo en Qt 6.0.

Véase también remove().

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

Devuelve un iterador que apunta al elemento con la clave « key » en el mapa.

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

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

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

Esta es una función sobrecargada.

T &QMap::first()

Devuelve una referencia al primer valor del mapa, es decir, el valor asociado a la clave más pequeña. Esta función da por hecho 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 last(), firstKey() y isEmpty().

const T &QMap::first() const

Esta es una función sobrecargada.

const Key &QMap::firstKey() const

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

Se ejecuta en tiempo constante.

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

void QMap::insert(QMap<Key, T> &&map)

Traslada todos los elementos de map a este mapa.

Si una clave es común a ambos mapas, su valor se sustituirá por el valor almacenado en map.

Si « map » es compartido, los elementos se copiarán en su lugar.

void QMap::insert(const QMap<Key, T> &map)

Inserta todos los elementos de map en este mapa.

Si una clave es común a ambos mapas, su valor se sustituirá por el valor almacenado en map.

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

Al insertar un par clave/valor con una clave ya existente, se sustituye el valor existente.

Devuelve un iterador que apunta al elemento nuevo o actualizado.

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

Inserta un nuevo elemento con la clave key y el valor value, junto con la sugerencia pos, que indica dónde debe realizarse la inserción.

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

Si ya existe un elemento con la clave key, el valor de ese elemento se sustituye por value.

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

Al crear un mapa a partir de datos ordenados, insertar primero la clave más grande con ` constBegin()` es más rápido que insertar en orden con ` constEnd()`, ya que ` constEnd()` - 1 (lo que se necesita para comprobar si la sugerencia es válida) requiere tiempo logarítmico.

Nota: Hay que tener cuidado con la sugerencia. Proporcionar un iterador de una instancia compartida anterior podría provocar un fallo, pero también existe el riesgo de que corrompa silenciosamente tanto el mapa como el mapa pos.

Devuelve un iterador que apunta al elemento nuevo o actualizado.

Esta es una función sobrecargada.

bool QMap::isEmpty() const

Devuelve « true » si el mapa no contiene ningún elemento; en caso contrario, devuelve «false».

Véase también size().

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

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

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

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

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

Devuelve un iterador constante al estilo STL que apunta a la primera clave del mapa.

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

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

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

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

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

Devuelve un iterador de tipo STL que apunta a la primera entrada del mapa.

Véase también ` keyValueEnd()`.

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

Devuelve un iterador const al estilo STL que apunta a la primera entrada del mapa.

Véase también ` keyValueEnd()`.

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

Devuelve un iterador de estilo STL que apunta a la entrada imaginaria situada después de la última entrada del mapa.

Véase también keyValueBegin().

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

Devuelve un iterador constante al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del mapa.

Véase también ` keyValueBegin()`.

QList<Key> QMap::keys() const

Devuelve una lista que contiene todas las claves del mapa en orden ascendente.

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 esto conlleva puede evitarse iterando desde ` keyBegin()` hasta ` keyEnd()`.

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

QList<Key> QMap::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), ya que la estructura de datos interna de QMap está optimizada para una búsqueda rápida por clave, no por valor.

Esta es una función sobrecargada.

T &QMap::last()

Devuelve una referencia al último valor del mapa, es decir, el valor asociado a la clave más grande. Esta función da por hecho 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 &QMap::last() const

Esta es una función sobrecargada.

const Key &QMap::lastKey() const

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

Se ejecuta en tiempo constante.

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

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

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

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

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

Esta es una función sobrecargada.

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

Elimina todos los elementos que tengan la clave « key » del mapa. Devuelve el número de elementos eliminados, que será 1 si la clave existe en el mapa y 0 en caso contrario.

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

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

Elimina del mapa todos los elementos para los que el predicado pred devuelve «true».

La función admite predicados que admiten como argumento un valor de tipo ` QMap<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.

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

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

Devuelve el número de pares (clave, valor) que hay en el mapa.

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

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

Cambia este mapa por other. Esta operación es muy rápida y nunca falla.

T QMap::take(const Key &key)

Elimina del mapa el elemento con la clave « key » y devuelve el valor asociado a él.

Si el elemento no existe en el mapa, la función simplemente devuelve un valor construido por defecto.

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

Véase también remove().

std::map<Key, T> QMap::toStdMap() const &

Devuelve un mapa STL equivalente a este: QMap.

[since 6.0] std::map<Key, T> QMap::toStdMap() &&

Nota: Al llamar a esta función, el objeto ` QMap ` quedará en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción o la asignación de un nuevo valor.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

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

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

Ejemplo:

QMap<int, QString> map;
map.insert(1, "one");
map.insert(5, "five");
map.insert(10, "ten");

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

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

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

Esta es una función sobrecargada.

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

Devuelve el valor asociado a la clave « key ».

Si el mapa no contiene ningún elemento con la clave « key », la función devuelve « defaultValue ». Si no se especifica ningún « defaultValue », la función devuelve un valor construido por defecto.

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

QList<T> QMap::values() const

Devuelve una lista que contiene todos los valores del mapa, ordenados de forma ascendente según sus claves.

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().

[implicit] QMap<Key, T> &QMap::operator=(QMap<Key, T> &&other)

Asigna « other » a esta instancia de « QMap ». .

[implicit] QMap<Key, T> &QMap::operator=(const QMap<Key, T> &other)

Asigna ` other ` a este mapa y devuelve una referencia a este mapa.

T &QMap::operator[](const Key &key)

Devuelve el valor asociado a la clave « key » como una referencia modificable.

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

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

T QMap::operator[](const Key &key) const

Es lo mismo que ` value()`.

Esta es una función sobrecargada.

Elementos no miembros relacionados

[since 6.1] template < typename Key, typename T, typename Predicate > qsizetype erase_if(QMap<Key, T> &map, Predicate pred)

Elimina del mapa map todos los elementos para los que el predicado pred devuelve «true».

La función admite predicados que toman como argumento un valor de tipo QMap<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.

[since 6.8] size_t qHash(const QMap<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()`.

Esta función se introdujo en Qt 6.8.

bool operator!=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Devuelve « true » si « lhs » no es igual a « rhs »; en caso contrario, devuelve «false».

Se considera que dos mapas son iguales si contienen los mismos pares (clave, valor).

Esta función requiere que los tipos de clave y de valor implementen operator==().

Véase también operator==().

[since 6.12] bool operator<(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Devuelve ` true ` si ` lhs ` es lexicográficamente menor que ` rhs`; en caso contrario, devuelve ` false`.

Este operador está disponible si tanto el tipo de clave Key como el tipo mapeado T proporcionan uno de los siguientes: operator<=>() (en modo C++20), el método auxiliar compareThreeWay() o operator<().

Esta función se introdujo en Qt 6.12.

template <typename Key, typename T> QDataStream &operator<<(QDataStream &out, const QMap<Key, T> &map)

Escribe el mapa map en el flujo out.

Esta función requiere que los tipos de clave y valor implementen operator<<().

Véase también el formato de los operadores de QDataStream.

[since 6.12] bool operator<=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Devuelve « true » si « lhs » es lexicográficamente menor o igual que « rhs »; en caso contrario, devuelve « false ».

Este operador está disponible si tanto el tipo de clave Key como el tipo mapeado T proporcionan uno de los siguientes: operator<=>() (en modo C++20), el método auxiliar compareThreeWay() o operator<().

Esta función se introdujo en Qt 6.12.

[since 6.12] auto operator<=>(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Compara el contenido de lhs y rhs en orden lexicográfico. Devuelve el resultado del tipo de categoría más específico aplicable.

Nota: Este operador solo está disponible en modo C++20 cuando tanto el tipo de clave Key como el tipo mapeado T cumplen los requisitos del concepto std::three_way_comparable o proporcionan operator<(). En este caso, los operadores <, <=, > y >= se sintetizan a partir de operator<=>() y operator==().

Esta función se introdujo en Qt 6.12.

bool operator==(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Devuelve « true » si « lhs » es igual a « rhs »; en caso contrario, devuelve «false».

Se considera que dos mapas son iguales si contienen los mismos pares (clave, valor).

Esta función requiere que los tipos de clave y valor implementen operator==().

Véase también operator!=().

[since 6.12] bool operator>(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Devuelve « true » si « lhs » es lexicográficamente mayor que « rhs »; en caso contrario, devuelve « false ».

Este operador está disponible si tanto el tipo de clave Key como el tipo mapeado T proporcionan uno de los siguientes: operator<=>() (en modo C++20), el método auxiliar compareThreeWay() o operator<().

Esta función se introdujo en Qt 6.12.

[since 6.12] bool operator>=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

Devuelve « true » si « lhs » es lexicográficamente mayor o igual que « rhs »; en caso contrario, devuelve « false ».

Este operador está disponible si tanto el tipo de clave Key como el tipo mapeado T proporcionan uno de los siguientes: operator<=>() (en modo C++20), el método auxiliar compareThreeWay() o operator<().

Esta función se introdujo en Qt 6.12.

template <typename Key, typename T> QDataStream &operator>>(QDataStream &in, QMap<Key, T> &map)

Lee un mapa desde el flujo « in » y lo guarda en « map ».

Esta función requiere que los tipos de clave y valor implementen operator>>().

Véase también Formato de los operadores de QDataStream.

© 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.