QMultiHash Class

Dokumentation zu den Mitgliedsfunktionen

[noexcept default] QMultiHash::QMultiHash()

Erstellt ein leeres Hash-Objekt.

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

Erstellt eine Kopie von „ other “ (bei dem es sich um ein „ QHash “ oder ein „QMultiHash“ handeln kann).

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

Erstellt einen Multi-Hash mit einer Kopie jedes Elements aus der Initialisierungsliste „ list “.

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

Erstellt einen Multi-Hash mit einer Kopie jedes Elements im Iteratorbereich [begin, end). Entweder müssen die Elemente, über die der Bereich iteriert wird, Objekte mit den Datenelementen ` first ` und ` second ` (wie z. B. ` std::pair`) sein, die jeweils in ` Key ` bzw. ` T ` konvertierbar sind; oder die Iteratoren müssen die Mitgliedsfunktionen ` key() ` und ` value() ` besitzen, die jeweils einen Schlüssel zurückgeben, der in ` Key ` konvertierbar ist, sowie einen Wert, der in ` T ` konvertierbar ist.

Gibt ein Bereichsobjekt zurück, das die Iteration über diesen Hash als Schlüssel-Wert-Paare ermöglicht. Dieses Bereichsobjekt kann beispielsweise 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 abgerufen werden, Referenzen auf die entsprechenden Elemente im Hash sind. Das bedeutet insbesondere, dass eine Änderung des Werts den Hash selbst verändert.

Diese Funktionen wurden in Qt 6.4 eingeführt.

Siehe auch QKeyValueIterator.

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

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

Siehe auch ` constBegin()` und ` end()`.

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

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

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

Siehe auch „ begin()“ und „ cend()“.

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

Gibt einen konstanten Iterator im STL-Stil 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 belegten Speicher frei.

Siehe auch ` remove()`.

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

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

Siehe auch ` begin()` und ` constEnd()`.

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

Gibt einen konstanten Iterator im STL-Stil 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 im Hash verweist, das den Wert „ key “ und den Wert „ value “ enthält.

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

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

Gibt einen konstanten Iterator im STL-Stil 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 konstanten Iterator im STL-Stil 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 den Schlüsseln „ key “ und „ value “ enthält; andernfalls wird „ false “ zurückgegeben.

Siehe auch count().

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

Gibt die Anzahl der Einträge zurück, die die Bedingungen „ key “ und „ value “ erfüllen.

Siehe auch contains().

Fügt ein neues Element in den Container ein. Dieses neue Element wird an Ort und Stelle unter Verwendung von ` args ` als Argumente für seine Erstellung konstruiert.

Befindet sich bereits ein Eintrag mit demselben Schlüssel im Hash, erstellt diese Funktion einfach einen neuen. (Dieses Verhalten unterscheidet sich von „ replace()“, das den Wert eines bestehenden Eintrags überschreibt.)

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

Siehe auch ` insert`.

Fügt ein neues Element in den Container ein. Dieses neue Element wird an Ort und Stelle unter Verwendung von args als Argumente für seine Erstellung gebildet.

Wenn im Hash bereits ein Element mit demselben Schlüssel vorhanden ist, wird dessen Wert durch einen Wert ersetzt, der aus ` args` erstellt wird.

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

Siehe auch ` replace ` und ` emplace`.

[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

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

Gibt ein Iteratorpaar zurück, das den Wertebereich [first, second) begrenzt, der unter key gespeichert ist. Ist der Bereich leer, 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

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

Entfernt das (Schlüssel, Wert)-Paar, das dem Iterator pos zugeordnet ist, aus dem Hash und gibt einen Iterator auf das nächste Element im Hash zurück.

Diese Funktion führt niemals dazu, dass QMultiHash seine interne Datenstruktur neu hasht. Das bedeutet, dass sie sicher während einer Iteration aufgerufen werden kann und die Reihenfolge der Elemente im Hash nicht beeinflusst. Zum Beispiel:

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

Siehe auch ` remove()`, ` take()` und ` find()`.

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

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

Enthält der Hash mehrere Elemente mit den Schlüsseln „ key “ und „ value “, verweist der zurückgegebene Iterator auf das zuletzt eingefügte Element.

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

Fügt einen neuen Eintrag mit dem Schlüssel „ key “ und dem Wert „ value “ ein.

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

QMultiHash Doppelte Schlüssel sind zulässig. Beim Einfügen eines bereits vorhandenen Schlüssels wird ein weiterer Eintrag hinzugefügt, anstatt den bestehenden zu überschreiben. Die Reihenfolge der Elemente in QMultHash ist nicht garantiert.

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

Siehe auch ` replace()`.

Diese Funktionen wurden in Qt 6.11 eingeführt.

Gibt den ersten Schlüssel zurück, der value zugeordnet ist. Wenn der Hash keinen Eintrag enthält, der value zugeordnet ist, wird defaultKey zurückgegeben oder ein standardmäßig konstruierter Schlüssel, falls dieser Parameter nicht angegeben wurde.

Diese Funktion kann langsam sein (lineare Laufzeit), da die interne Datenstruktur von ` QMultiHash` für eine schnelle Suche nach Schlüsseln und nicht nach Werten optimiert ist.

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

Gibt einen konstanten Iterator im STL-Stil 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 konstanten Iterator im STL-Stil 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 konstanten Iterator im STL-Stil 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 konstanten Iterator im STL-Stil 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 Hashs in beliebiger Reihenfolge enthält. Schlüssel, die im Hash mehrfach vorkommen, tauchen auch in der Liste mehrfach auf.

Es wird garantiert, dass die Reihenfolge mit der übereinstimmt, die von ` values()` verwendet wird.

Diese Funktion erstellt in linearer Zeit eine neue Liste. Der damit verbundene Zeit- und Speicherbedarf lässt sich vermeiden, indem man statt keyBegin() die Funktion keyEnd() verwendet.

Siehe auch values() und key().

qsizetype QMultiHash::remove(const Key &key)

Entfernt alle Elemente aus dem Hash, die den Schlüssel „ key “ haben. Gibt die Anzahl der entfernten Elemente zurück.

Siehe auch remove(const Key &key, const T &value).

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

Entfernt alle Elemente aus dem Hash, die den Schlüssel „ key “ und den Wert „ value “ haben. 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 aus dem Multi-Hash, für die das Prädikat „ pred “ den Wert „true“ zurückgibt.

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, sofern 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 einen neuen Eintrag mit dem Schlüssel „ key “ und dem Wert „ value “ ein.

Falls bereits ein Eintrag mit dem key vorhanden ist, wird dessen Wert durch value ersetzt.

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

Gibt einen Iterator zurück, der auf das neue bzw. aktualisierte Element verweist.

Siehe auch „ insert()“.

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

Ersetzt diesen Multi-Hash durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

T QMultiHash::take(const Key &key)

Entfernt das Element mit dem Schlüssel „ key “ aus dem Hash und gibt den damit verknüpften Wert zurück.

Wenn der Eintrag im Hash nicht vorhanden ist, gibt die Funktion einfach einen standardmäßig konstruierten Wert zurück. Wenn im Hash mehrere Einträge für „ key “ vorhanden sind, wird nur der 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 zurück, die alle Schlüssel des Maps enthält. Schlüssel, die im Map mehrfach vorkommen, erscheinen in der zurückgegebenen Liste nur einmal.

Siehe auch „ keys()“ und „ values()“.

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

Fügt alle Elemente des Hashs „ 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 aus dem Hash „ other “ in diesen Hash ein und gibt eine Referenz auf diesen Hash zurück.

Siehe auch ` insert()`.

Gibt den Wert zurück, der dem „ key “ zugeordnet ist.

Enthält der Hash keinen Eintrag mit dem key, gibt die Funktion defaultValue zurück oder einen standardmäßig konstruierten Wert, falls dieser Parameter nicht angegeben wurde.

Befinden sich mehrere Einträge für den „ key “ im Hash, wird der Wert des zuletzt eingefügten Eintrags zurückgegeben.

QList<T> QMultiHash::values() const

Gibt eine Liste zurück, die alle Werte des Hashs in beliebiger Reihenfolge enthält. Ist einem Schlüssel mehr als ein Wert zugeordnet, werden alle diese Werte in die Liste aufgenommen – nicht nur der zuletzt eingefügte.

Es wird garantiert, dass die Reihenfolge mit der von ` keys()` übereinstimmt.

Diese Funktion erstellt eine neue Liste in linearer Zeit. Der damit verbundene Zeit- und Speicherverbrauch lässt sich vermeiden, indem man statt ` keyValueBegin()` die Funktion ` keyValueEnd()` verwendet.

Siehe auch keys() und value().

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

Gibt eine Liste aller Werte zurück, die mit der Funktion „ key “ verknüpft sind, sortiert vom zuletzt eingefügten bis zum am längsten zurückliegenden.

Siehe auch „ count()“ und „ insert()“.

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

Gibt einen Hash zurück, der alle Elemente dieses Hashs sowie alle Elemente von other enthält. Wenn ein Schlüssel in beiden Hashs vorkommt, enthält der resultierende Hash diesen Schlüssel mehrfach.

Siehe auch operator+=().

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

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

Siehe auch „ unite()“ und „ insert()“.

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

Gibt den Wert zurück, der dem „ key “ zugeordnet ist, als bearbeitbare Referenz.

Enthält der Hash keinen Eintrag mit dem Schlüssel „ key “, fügt die Funktion einen standardmäßig konstruierten Wert mit dem Schlüssel „ key “ in den Hash ein und gibt eine Referenz darauf zurück.

Enthält der Hash mehrere Elemente mit dem key, gibt diese Funktion eine Referenz auf den zuletzt eingefügten Wert zurück.

Siehe auch ` insert()` und ` value()`.