QMultiHash Class

Dokumentation der Mitgliedsfunktionen

Fügt ein neues Element in den Container ein. Dieses neue Element wird an Ort und Stelle konstruiert, wobei args als Argumente für seine Konstruktion verwendet werden.

Wenn bereits ein Element mit demselben Schlüssel im Hash vorhanden ist, wird mit dieser Funktion einfach ein neues Element erstellt. (Dieses Verhalten unterscheidet sich von replace(), das den Wert eines vorhandenen Elements überschreibt).

Gibt einen Iterator zurück, der auf das neue Element zeigt.

Siehe auch insert.

Fügt ein neues Element in den Container ein. Dieses neue Element wird an Ort und Stelle konstruiert, wobei args als Argumente für seine Konstruktion verwendet werden.

Wenn es bereits ein Element mit demselben Schlüssel im Hash gibt, wird der Wert dieses Elements durch einen aus args konstruierten Wert ersetzt.

Gibt einen Iterator zurück, der auf das neue Element zeigt.

Siehe auch replace und emplace.

Gibt den mit key verbundenen Wert zurück.

Enthält der Hash kein Element mit der Bezeichnung key, gibt die Funktion defaultValue zurück oder einen standardmäßig konstruierten Wert, wenn dieser Parameter nicht angegeben wurde.

Gibt es mehrere Elemente für key im Hash, wird der Wert des zuletzt eingefügten zurückgegeben.

Gibt den ersten Schlüssel zurück, der value zugeordnet ist. Enthält der Hash kein Element, das value zugeordnet ist, wird defaultKey zurückgegeben, oder ein standardmäßig konstruierter Schlüssel, wenn dieser Parameter nicht übergeben wurde.

Diese Funktion kann langsam sein(lineare Zeit), da die interne Datenstruktur von QMultiHash für die schnelle Suche nach dem Schlüssel und nicht nach dem Wert optimiert ist.

Gibt ein Bereichsobjekt zurück, das die Iteration über diesen Hash als Schlüssel/Wert-Paare ermöglicht. Dieses Bereichsobjekt kann zum Beispiel in einer bereichsbasierten for-Schleife in Kombination mit einer strukturierten Bindungsdeklaration verwendet werden:

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
}

Beachten Sie, dass sowohl der Schlüssel als auch der Wert, die auf diese Weise erhalten werden, Verweise auf die im Hash enthaltenen Werte sind. Insbesondere wird durch die Änderung des Wertes der Hash selbst geändert.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch QKeyValueIterator.

[noexcept] QMultiHash::QMultiHash()

Konstruiert einen leeren Hash.

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

Konstruiert eine Kopie von other (das ein QHash oder ein QMultiHash sein kann).

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

Konstruiert einen Multi-Hash mit einer Kopie von jedem der Elemente in der Initialisierungsliste list.

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

Konstruiert einen Multi-Hash mit einer Kopie von jedem der Elemente im Iteratorbereich [begin, end). Entweder müssen die Elemente, die durch den Bereich iteriert werden, Objekte mit den Datenelementen first und second (wie std::pair) sein, die in Key bzw. T konvertierbar sind; oder die Iteratoren müssen über die Mitgliederfunktionen key() und value() verfügen, die einen in Key konvertierbaren Schlüssel bzw. einen in T konvertierbaren Wert zurückgeben.

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

Gibt einen Iterator im STL-Stil zurück, der auf das erste Element des Hashes zeigt.

Siehe auch constBegin() und end().

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

Dies ist eine überladene Funktion.

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

Gibt einen Iterator im Stil von const STL zurück, der auf das erste Element des Hashes zeigt.

Siehe auch begin() und cend().

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

Gibt einen const STL-artigen Iterator zurück, der auf das imaginäre Element nach dem letzten Element im Hash zeigt.

Siehe auch cbegin() und end().

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

Entfernt alle Elemente aus dem Hash und gibt den gesamten von ihm verwendeten Speicher frei.

Siehe auch remove().

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

Gibt einen Iterator im Stil von const STL zurück, der auf das erste Element des Hashes zeigt.

Siehe auch begin() und constEnd().

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

Gibt einen const STL-artigen Iterator zurück, der auf das imaginäre Element nach dem letzten Element im Hash zeigt.

Siehe auch constBegin() und end().

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

Gibt einen Iterator zurück, der auf das Element mit dem key und dem value im Hash zeigt.

Wenn der Hash kein solches Element enthält, gibt die Funktion constEnd() zurück.

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

Gibt einen const STL-artigen Iterator zurück, der auf den ersten Eintrag im Hash zeigt.

Siehe auch keyValueBegin().

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

Gibt einen const STL-artigen Iterator zurück, der auf den imaginären Eintrag nach dem letzten Eintrag im Hash zeigt.

Siehe auch constKeyValueBegin().

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

Gibt true zurück, wenn der Hash ein Element mit dem key und value enthält; andernfalls wird false zurückgegeben.

Siehe auch contains().

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

Liefert die Anzahl der Elemente mit dem key und value.

Siehe auch count().

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

Gibt einen Iterator im STL-Stil zurück, der auf das imaginäre Element nach dem letzten Element im Hash zeigt.

Siehe auch begin() und constEnd().

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

Dies ist eine überladene Funktion.

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

Gibt ein Paar von Iteratoren zurück, die den Bereich der Werte [first, second) begrenzen, die unter key gespeichert sind. Wenn der Bereich leer ist, sind beide Iteratoren gleich end().

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

Dies ist eine überladene Funktion.

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

Gibt einen Iterator zurück, der auf das Element mit den Bezeichnungen key und value zeigt. Enthält der Hash kein solches Element, gibt die Funktion end() zurück.

Enthält der Hash mehrere Einträge mit den Kennzeichnungen key und value, zeigt der zurückgegebene Iterator auf den zuletzt eingefügten Eintrag.

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

Dies ist eine überladene Funktion.

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

Fügt ein neues Element mit der Adresse key und einem Wert von value ein.

Wenn bereits ein Element mit demselben Schlüssel im Hash vorhanden ist, wird mit dieser Funktion einfach ein neues Element erstellt. (Dieses Verhalten unterscheidet sich von replace(), das den Wert eines vorhandenen Elements überschreibt).

Gibt einen Iterator zurück, der auf das neue Element zeigt.

Siehe auch replace().

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

Gibt einen const STL-artigen Iterator zurück, der auf den ersten Schlüssel im Hash zeigt.

Siehe auch keyEnd().

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

Gibt einen const STL-artigen Iterator zurück, der auf das imaginäre Element nach dem letzten Schlüssel im Hash zeigt.

Siehe auch keyBegin().

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

Gibt einen Iterator im STL-Stil zurück, der auf den ersten Eintrag im Hash zeigt.

Siehe auch keyValueEnd().

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

Gibt einen const STL-artigen Iterator zurück, der auf den ersten Eintrag im Hash zeigt.

Siehe auch keyValueEnd().

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

Gibt einen Iterator im STL-Stil zurück, der auf den imaginären Eintrag nach dem letzten Eintrag im Hash zeigt.

Siehe auch keyValueBegin().

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

Gibt einen const STL-artigen Iterator zurück, der auf den imaginären Eintrag nach dem letzten Eintrag im Hash zeigt.

Siehe auch keyValueBegin().

QList<Key> QMultiHash::keys() const

Gibt eine Liste zurück, die alle Schlüssel des Hashes in beliebiger Reihenfolge enthält. Schlüssel, die mehrfach im Hash vorkommen, kommen auch mehrfach in der Liste vor.

Die Reihenfolge ist garantiert dieselbe wie die von values() verwendete.

Diese Funktion erstellt eine neue Liste in linearer Zeit. Der damit verbundene Zeit- und Speicherbedarf kann durch Iteration von keyBegin() zu keyEnd() vermieden werden.

Siehe auch values() und key().

qsizetype QMultiHash::remove(const Key &key)

Entfernt alle Elemente, die die Adresse key haben, aus dem Hash. Gibt die Anzahl der entfernten Elemente zurück.

Siehe auch remove().

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

Entfernt alle Elemente, die den key und den Wert value haben, aus dem Hash. Gibt die Anzahl der entfernten Elemente zurück.

Siehe auch remove().

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

Entfernt alle Elemente, für die das Prädikat pred wahr ergibt, aus dem Multi-Hash.

Die Funktion unterstützt Prädikate, die entweder ein Argument vom Typ QMultiHash<Key, T>::iterator oder ein Argument vom Typ std::pair<const Key &, T &> annehmen.

Gibt die Anzahl der entfernten Elemente zurück, falls vorhanden.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch clear() und take().

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

Fügt ein neues Element mit der Bezeichnung key und einem Wert von value ein.

Wenn es bereits ein Element mit der Bezeichnung key gibt, wird der Wert dieses Elements durch value ersetzt.

Wenn es mehrere Elemente mit dem Wert key gibt, wird der Wert des zuletzt eingefügten Elements durch value ersetzt.

Gibt einen Iterator zurück, der auf das neue/aktualisierte Element zeigt.

Siehe auch insert().

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

Tauscht diesen Multi-Hash mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

T QMultiHash::take(const Key &key)

Entfernt das Element mit der Adresse key aus dem Hash und gibt den damit verbundenen Wert zurück.

Wenn das Element im Hash nicht vorhanden ist, gibt die Funktion einfach einen standardmäßig konstruierten Wert zurück. Wenn mehrere Elemente für key im Hash vorhanden sind, wird nur das zuletzt eingefügte entfernt.

Wenn Sie den Rückgabewert nicht verwenden, ist remove() effizienter.

Siehe auch remove().

QList<Key> QMultiHash::uniqueKeys() const

Gibt eine Liste mit allen Schlüsseln in der Map zurück. Schlüssel, die mehrfach in der Map vorkommen, erscheinen nur einmal in der zurückgegebenen Liste.

Siehe auch keys() und values().

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

Fügt alle Elemente des Hashes other in diesen Hash ein und gibt eine Referenz auf diesen Hash zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch insert().

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

Fügt alle Elemente des Hashes other in diesen Hash ein und gibt einen Verweis auf diesen Hash zurück.

Siehe auch insert().

QList<T> QMultiHash::values() const

Gibt eine Liste zurück, die alle Werte des Hashes in beliebiger Reihenfolge enthält. Wenn ein Schlüssel mit mehreren Werten verknüpft ist, werden alle seine Werte in der Liste aufgeführt, nicht nur der zuletzt eingefügte Wert.

Die Reihenfolge ist garantiert dieselbe wie die von keys() verwendete.

Diese Funktion erstellt eine neue Liste in linearer Zeit. Der damit verbundene Zeit- und Speicherbedarf kann durch Iteration von keyValueBegin() zu keyValueEnd() vermieden werden.

Siehe auch keys() und value().

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

Dies ist eine überladene Funktion.

Gibt eine Liste aller mit key verbundenen Werte zurück, vom zuletzt eingefügten bis zum zuletzt eingefügten Wert.

Siehe auch count() und insert().

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

Gibt einen Hash zurück, der alle Elemente in diesem Hash zusätzlich zu allen Elementen in other enthält. Wenn ein Schlüssel in beiden Hashes vorkommt, enthält der resultierende Hash den Schlüssel mehrfach.

Siehe auch operator+=().

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

Fügt alle Elemente des Hashes other in diesen Hash ein und gibt einen Verweis auf diesen Hash zurück.

Siehe auch unite() und insert().

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

Gibt den mit key verbundenen Wert als veränderbaren Verweis zurück.

Enthält der Hash kein Element mit der Bezeichnung key, fügt die Funktion einen standardmäßig konstruierten Wert in den Hash mit der Bezeichnung key ein und gibt einen Verweis auf diesen zurück.

Wenn der Hash mehrere Elemente mit der key enthält, gibt diese Funktion einen Verweis auf den zuletzt eingefügten Wert zurück.

Siehe auch insert() und value().