QMultiHash Class

Documentation des fonctions membres

[noexcept] QMultiHash::QMultiHash()

Construit un hachage vide.

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

Construit une copie de other (qui peut être un QHash ou un QMultiHash).

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

Construit un multi-hash avec une copie de chacun des éléments de la liste d'initialisation list.

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

Construit un multi-hash avec une copie de chacun des éléments de l'intervalle de l'itérateur [begin, end). Soit les éléments itérés par la plage doivent être des objets avec des membres de données first et second (comme std::pair), convertibles en Key et T respectivement ; soit les itérateurs doivent avoir des fonctions membres key() et value(), renvoyant une clé convertible en Key et une valeur convertible en T respectivement.

Renvoie un objet de plage qui permet d'itérer sur ce hachage sous forme de paires clé/valeur. Par exemple, cet objet plage peut être utilisé dans une boucle for basée sur la plage, en combinaison avec une déclaration de liaison structurée :

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
}

Notez que la clé et la valeur obtenues de cette manière sont des références à celles du hachage. Plus précisément, la modification de la valeur modifiera le hachage lui-même.

Ces fonctions ont été introduites dans Qt 6.4.

Voir aussi QKeyValueIterator.

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

Renvoie un itérateur de style STL pointant sur le premier élément du hachage.

Voir aussi constBegin() et end().

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

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

Renvoie un itérateur constant de style STL pointant sur le premier élément du hachage.

Voir aussi begin() et cend().

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

Renvoie un itérateur constant de style STL pointant vers l'élément imaginaire situé après le dernier élément du hachage.

Voir aussi cbegin() et end().

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

Supprime tous les éléments du hachage et libère toute la mémoire utilisée par celui-ci.

Voir également remove().

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

Renvoie un itérateur constant de style STL pointant sur le premier élément du hachage.

Voir aussi begin() et constEnd().

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

Renvoie un itérateur constant de style STL pointant vers l'élément imaginaire situé après le dernier élément du hachage.

Voir aussi constBegin() et end().

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

Renvoie un itérateur pointant vers l'élément contenant key et value dans le hachage.

Si le hachage ne contient aucun élément de ce type, la fonction renvoie constEnd().

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

Renvoie un itérateur constant de style STL pointant sur la première entrée du hachage.

Voir aussi keyValueBegin().

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

Renvoie un itérateur constant de style STL pointant vers l'entrée imaginaire située après la dernière entrée du hachage.

Voir aussi constKeyValueBegin().

[noexcept] bool QMultiHash::contains(const Key &key, const T &value) const

Renvoie true si le hachage contient un élément avec key et value; sinon, renvoie false.

Voir aussi count().

[noexcept] qsizetype QMultiHash::count(const Key &key, const T &value) const

Renvoie le nombre d'éléments portant les noms key et value.

Voir aussi contains().

Insère un nouvel élément dans le conteneur. Ce nouvel élément est construit sur place en utilisant args comme arguments pour sa construction.

S'il existe déjà un élément avec la même clé dans le hachage, cette fonction en créera simplement un nouveau. (Ce comportement est différent de celui de replace(), qui écrase la valeur d'un élément existant).

Renvoie un itérateur pointant vers le nouvel élément.

Voir aussi insert.

Insère un nouvel élément dans le conteneur. Ce nouvel élément est construit sur place en utilisant args comme arguments pour sa construction.

S'il existe déjà un élément avec la même clé dans le hachage, la valeur de cet élément est remplacée par une valeur construite à partir de args.

Retourne un itérateur pointant vers le nouvel élément.

Voir aussi replace et emplace.

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

Renvoie un itérateur de style STL pointant vers l'élément imaginaire situé après le dernier élément du hachage.

Voir aussi begin() et 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)

Renvoie une paire d'itérateurs délimitant la plage de valeurs [first, second), qui sont stockées sous key. Si la plage est vide, les deux itérateurs seront égaux à 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)

Supprime la paire (clé, valeur) associée à l'itérateur pos du hachage et renvoie un itérateur vers l'élément suivant du hachage.

Cette fonction n'oblige jamais QMultiHash à réorganiser sa structure de données interne. Cela signifie qu'elle peut être appelée en toute sécurité pendant l'itération et qu'elle n'affectera pas l'ordre des éléments dans le hachage. Par exemple, cette fonction peut être appelée en toute sécurité pendant l'exécution d'une requête :

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

Voir aussi remove(), take(), et find().

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

Renvoie un itérateur pointant vers l'élément avec les codes key et value. Si le hachage ne contient aucun élément de ce type, la fonction renvoie end().

Si le hachage contient plusieurs éléments avec key et value, l'itérateur retourné pointe vers l'élément le plus récemment inséré.

[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)

Insère un nouvel élément avec la clé key et la valeur value.

S'il existe déjà un élément avec la même clé dans le hachage, cette fonction en créera simplement un nouveau. (Ce comportement est différent de celui de replace(), qui écrase la valeur d'un élément existant).

Renvoie un itérateur pointant vers le nouvel élément.

Voir aussi replace().

Ces fonctions ont été introduites dans Qt 6.11.

Renvoie la première clé associée à value. Si le hachage ne contient aucun élément associé à value, il renvoie defaultKey, ou une clé construite par défaut si ce paramètre n'a pas été fourni.

Cette fonction peut être lente(temps linéaire), car la structure de données interne de QMultiHash est optimisée pour une recherche rapide par clé, et non par valeur.

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

Renvoie un itérateur constant de style STL pointant sur la première clé du hachage.

Voir aussi keyEnd().

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

Renvoie un itérateur constant de style STL pointant vers l'élément imaginaire situé après la dernière clé du hachage.

Voir aussi keyBegin().

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

Renvoie un itérateur de style STL pointant sur la première entrée du hachage.

Voir aussi keyValueEnd().

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

Renvoie un itérateur constant de style STL pointant sur la première entrée du hachage.

Voir aussi keyValueEnd().

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

Renvoie un itérateur de style STL pointant vers l'entrée imaginaire située après la dernière entrée du hachage.

Voir aussi keyValueBegin().

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

Renvoie un itérateur constant de style STL pointant vers l'entrée imaginaire située après la dernière entrée du hachage.

Voir aussi keyValueBegin().

QList<Key> QMultiHash::keys() const

Renvoie une liste contenant toutes les clés du hachage, dans un ordre arbitraire. Les clés qui apparaissent plusieurs fois dans le hachage apparaissent également plusieurs fois dans la liste.

L'ordre est garanti être le même que celui utilisé par values().

Cette fonction crée une nouvelle liste en temps linéaire. L'utilisation du temps et de la mémoire que cela implique peut être évitée en itérant de keyBegin() à keyEnd().

Voir aussi values() et key().

qsizetype QMultiHash::remove(const Key &key)

Supprime tous les éléments qui ont la valeur key dans le hachage. Renvoie le nombre d'éléments supprimés.

Voir aussi remove(const Key &key, const T &value).

qsizetype QMultiHash::remove(const Key &key, const T &value)

Supprime du hachage tous les éléments qui ont la valeur key et la valeur value. Renvoie le nombre d'éléments supprimés.

Voir aussi remove().

[since 6.1] template <typename Predicate> qsizetype QMultiHash::removeIf(Predicate pred)

Supprime du hachage multi tous les éléments pour lesquels le prédicat pred renvoie la valeur "true".

La fonction prend en charge les prédicats qui prennent soit un argument de type QMultiHash<Key, T>::iterator, soit un argument de type std::pair<const Key &, T &>.

Elle renvoie le nombre d'éléments supprimés, le cas échéant.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi clear() et take().

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

Insère un nouvel élément avec l'adresse key et la valeur value.

S'il existe déjà un élément avec la valeur key, la valeur de cet élément est remplacée par value.

S'il existe plusieurs éléments avec la valeur key, la valeur de l'élément le plus récemment inséré est remplacée par value.

Renvoie un itérateur pointant vers l'élément nouveau/mise à jour.

Voir aussi insert().

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

Échange ce multi-hash avec other. Cette opération est très rapide et n'échoue jamais.

T QMultiHash::take(const Key &key)

Retire l'élément avec le key du hachage et renvoie la valeur qui lui est associée.

Si l'élément n'existe pas dans le hachage, la fonction renvoie simplement une valeur construite par défaut. S'il y a plusieurs éléments pour key dans le hachage, seul le dernier inséré est supprimé.

Si vous n'utilisez pas la valeur de retour, remove() est plus efficace.

Voir également remove().

QList<Key> QMultiHash::uniqueKeys() const

Renvoie une liste contenant toutes les clés de la carte. Les clés qui apparaissent plusieurs fois dans la carte n'apparaissent qu'une seule fois dans la liste retournée.

Voir aussi keys() et values().

[since 6.0] QMultiHash<Key, T> &QMultiHash::unite(const QHash<Key, T> &other)

Insère tous les éléments du hachage other dans ce hachage et renvoie une référence à ce hachage.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi insert().

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

Insère tous les éléments du hachage other dans ce hachage et renvoie une référence à ce hachage.

Voir aussi insert().

Renvoie la valeur associée à key.

Si le hachage ne contient aucun élément avec key, la fonction renvoie defaultValue, ou une valeur construite par défaut si ce paramètre n'a pas été fourni.

S'il y a plusieurs éléments pour key dans le hachage, la valeur de l'élément le plus récemment inséré est renvoyée.

QList<T> QMultiHash::values() const

Renvoie une liste contenant toutes les valeurs du hachage, dans un ordre arbitraire. Si une clé est associée à plusieurs valeurs, toutes ses valeurs figureront dans la liste, et pas seulement la plus récente.

L'ordre est garanti être le même que celui utilisé par keys().

Cette fonction crée une nouvelle liste en temps linéaire. L'utilisation du temps et de la mémoire que cela implique peut être évitée en itérant de keyValueBegin() à keyValueEnd().

Voir aussi keys() et value().

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

Renvoie une liste de toutes les valeurs associées à key, de la plus récente à la moins récente.

Voir aussi count() et insert().

QMultiHash<Key, T> QMultiHash::operator+(const QMultiHash<Key, T> &other) const

Renvoie un hachage qui contient tous les éléments de ce hachage en plus de tous les éléments de other. Si une clé est commune aux deux hachages, le hachage résultant contiendra la clé plusieurs fois.

Voir également operator+=().

QMultiHash<Key, T> &QMultiHash::operator+=(const QMultiHash<Key, T> &other)

Insère tous les éléments du hachage other dans ce hachage et renvoie une référence à ce hachage.

Voir aussi unite() et insert().

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

Renvoie la valeur associée à key sous la forme d'une référence modifiable.

Si le hachage ne contient aucun élément avec key, la fonction insère une valeur construite par défaut dans le hachage avec key, et renvoie une référence à cette valeur.

Si le hachage contient plusieurs éléments avec key, cette fonction renvoie une référence à la dernière valeur insérée.

Voir aussi insert() et value().