QMap Class

Dokumentation der Mitgliedsfunktionen

Gibt ein Bereichsobjekt zurück, das die Iteration über diese Map 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:

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
}

Beachten Sie, dass sowohl der Schlüssel als auch der Wert, die auf diese Weise erhalten werden, Referenzen auf die Werte in der Map sind. Das Ändern des Wertes wird die Map selbst verändern.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch QKeyValueIterator.

QMap::QMap()

Konstruiert eine leere Karte.

Siehe auch clear().

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

Konstruiert eine Kopie von other.

Siehe auch toStdMap().

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

Konstruiert eine Karte mit einer Kopie von jedem der Elemente in der Initialisierungsliste list.

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

Konstruiert eine Karte durch Verschieben von other.

Siehe auch toStdMap().

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

Konstruiert eine Kopie von other.

Dieser Vorgang erfolgt in konstanter Zeit, da QMap implizit gemeinsam genutzt wird. Dies macht die Rückgabe einer QMap aus einer Funktion sehr schnell. Wenn eine gemeinsam genutzte Instanz geändert wird, wird sie kopiert (copy-on-write), was lineare Zeit benötigt.

Siehe auch operator=.

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

Move-konstruiert eine QMap-Instanz.

[default] QMap::~QMap()

Zerstört die Map. Verweise auf die Werte in der Map und alle Iteratoren über diese Map werden ungültig.

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

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

Siehe auch constBegin() und end().

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

Dies ist eine überladene Funktion.

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

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

Siehe auch begin() und cend().

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

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

Siehe auch cbegin() und end().

void QMap::clear()

Entfernt alle Elemente aus der Karte.

Siehe auch remove().

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

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

Siehe auch begin() und constEnd().

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

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

Siehe auch constBegin() und end().

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

Gibt einen const-Iterator zurück, der auf das Element mit dem Schlüssel key in der Map zeigt.

Wenn die Map kein Element mit dem Schlüssel key enthält, gibt die Funktion constEnd() zurück.

Siehe auch find().

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

Gibt einen Iterator im Stil von const STL zurück, der auf den ersten Eintrag in der Map zeigt.

Siehe auch keyValueBegin().

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

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

Siehe auch constKeyValueBegin().

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

Gibt true zurück, wenn die Karte ein Element mit dem Schlüssel key enthält; andernfalls wird false zurückgegeben.

Siehe auch count().

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

Gibt die Anzahl der mit dem Schlüssel key verbundenen Elemente zurück.

Siehe auch contains().

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

Dies ist eine überladene Funktion.

Dasselbe wie size().

bool QMap::empty() const

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu isEmpty() und gibt true zurück, wenn die Karte leer ist; andernfalls gibt sie false zurück.

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

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

Siehe auch begin() und constEnd().

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

Dies ist eine überladene Funktion.

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

Gibt ein Paar von Iteratoren zurück, die den Wertebereich [first, second) abgrenzen, der unter key gespeichert ist.

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

Dies ist eine überladene Funktion.

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

Entfernt das Paar (Schlüssel, Wert), auf das der Iterator pos zeigt, aus der Map und gibt einen Iterator zum nächsten Element in der Map zurück.

Siehe auch remove().

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

Entfernt die Paare (Schlüssel, Wert), auf die der Iteratorbereich [first, last) zeigt, aus der Map. Gibt einen Iterator zu dem Element in der Map zurück, das auf das letzte entfernte Element folgt.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch remove().

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

Gibt einen Iterator zurück, der auf das Element mit dem Schlüssel key in der Map zeigt.

Wenn die Karte kein Element mit dem Schlüssel key enthält, gibt die Funktion end() zurück.

Siehe auch constFind(), value(), values(), lowerBound(), und upperBound().

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

Dies ist eine überladene Funktion.

T &QMap::first()

Gibt einen Verweis auf den ersten Wert in der Map zurück, d. h. den Wert, der dem kleinsten Schlüssel zugeordnet ist. Diese Funktion geht davon aus, dass die Map nicht leer ist.

Wenn unshared (oder const version) aufgerufen wird, wird sie in konstanter Zeit ausgeführt.

Siehe auch last(), firstKey(), und isEmpty().

const T &QMap::first() const

Dies ist eine überladene Funktion.

const Key &QMap::firstKey() const

Gibt einen Verweis auf den kleinsten Schlüssel in der Map zurück. Diese Funktion geht davon aus, dass die Map nicht leer ist.

Sie wird in konstanter Zeit ausgeführt.

Siehe auch lastKey(), first(), keyBegin(), und isEmpty().

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

Verschiebt alle Elemente aus map in diese Map.

Wenn ein Schlüssel für beide Maps gleich ist, wird sein Wert durch den in map gespeicherten Wert ersetzt.

Wenn map gemeinsam genutzt wird, werden die Elemente stattdessen kopiert.

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

Fügt alle Elemente in map in diese Map ein.

Wenn ein Schlüssel in beiden Maps vorkommt, wird sein Wert durch den in map gespeicherten Wert ersetzt.

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

Fügt ein neues Element mit dem Schlüssel key und einem Wert von value ein.

Wenn es bereits ein Element mit dem Schlüssel key gibt, wird der Wert dieses Elements durch value ersetzt.

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

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

Dies ist eine überladene Funktion.

Fügt ein neues Element mit dem Schlüssel key und dem Wert value und mit dem Hinweis pos ein, der angibt, wo die Einfügung erfolgen soll.

Wenn constBegin() als Hinweis verwendet wird, zeigt es an, dass key kleiner als ein beliebiger Schlüssel in der Karte ist, während constEnd() vorschlägt, dass key (unbedingt) größer als ein beliebiger Schlüssel in der Karte ist. Ansonsten sollte der Hinweis die Bedingung (pos - 1) erfüllen.key() < key <= pos.key(). Wenn der Hinweis pos falsch ist, wird er ignoriert und eine reguläre Einfügung durchgeführt.

Wenn es bereits ein Element mit dem Schlüssel key gibt, wird der Wert dieses Elements durch value ersetzt.

Wenn der Hinweis korrekt ist und die Map nicht gemeinsam genutzt wird, wird die Einfügung in amortisierter konstanter Zeit ausgeführt.

Bei der Erstellung einer Map aus sortierten Daten ist das Einfügen des größten Schlüssels zuerst mit constBegin() schneller als das Einfügen in sortierter Reihenfolge mit constEnd(), da constEnd() - 1 (das zur Überprüfung der Gültigkeit des Hinweises benötigt wird) logarithmische Zeit benötigt.

Hinweis: Seien Sie vorsichtig mit dem Hint. Die Bereitstellung eines Iterators aus einer älteren gemeinsamen Instanz könnte zum Absturz führen, aber es besteht auch das Risiko, dass sowohl die Map als auch die pos Map stillschweigend beschädigt werden.

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

bool QMap::isEmpty() const

Gibt true zurück, wenn die Karte keine Elemente enthält; andernfalls wird false zurückgegeben.

Siehe auch size().

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

Dies ist eine überladene Funktion.

Gibt den ersten Schlüssel mit dem Wert value zurück, oder defaultKey, wenn die Karte kein Element mit dem Wert value enthält. Wenn kein defaultKey angegeben wird, gibt die Funktion einen standardmäßig konstruierten Schlüssel zurück.

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

Siehe auch value() und keys().

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

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

Siehe auch keyEnd() und firstKey().

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

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

Siehe auch keyBegin() und lastKey().

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

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

Siehe auch keyValueEnd().

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

Gibt einen Iterator im Stil von const STL zurück, der auf den ersten Eintrag in der Map zeigt.

Siehe auch keyValueEnd().

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

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

Siehe auch keyValueBegin().

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

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

Siehe auch keyValueBegin().

QList<Key> QMap::keys() const

Gibt eine Liste zurück, die alle Schlüssel der Map in aufsteigender Reihenfolge enthält.

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

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

Dies ist eine überladene Funktion.

Gibt eine Liste zurück, die alle mit dem Wert value verbundenen Schlüssel in aufsteigender Reihenfolge enthält.

Diese Funktion kann langsam sein(lineare Zeit), da die interne Datenstruktur von QMap für schnelles Nachschlagen nach Schlüssel und nicht nach Wert optimiert ist.

T &QMap::last()

Gibt einen Verweis auf den letzten Wert in der Map zurück, d. h. den Wert, der dem größten Schlüssel zugeordnet ist. Diese Funktion geht davon aus, dass die Map nicht leer ist.

Wenn unshared (oder die const-Version) aufgerufen wird, wird sie in logarithmischer Zeit ausgeführt.

Siehe auch first(), lastKey(), und isEmpty().

const T &QMap::last() const

Dies ist eine überladene Funktion.

const Key &QMap::lastKey() const

Gibt einen Verweis auf den größten Schlüssel in der Map zurück. Diese Funktion geht davon aus, dass die Map nicht leer ist.

Sie wird in logarithmischer Zeit ausgeführt.

Siehe auch firstKey(), last(), keyEnd(), und isEmpty().

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

Gibt einen Iterator zurück, der auf das erste Element mit dem Schlüssel key in der Map zeigt. Wenn die Map kein Element mit dem Schlüssel key enthält, gibt die Funktion einen Iterator zurück, der auf das nächstgelegene Element mit einem größeren Schlüssel zeigt.

Siehe auch upperBound() und find().

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

Dies ist eine überladene Funktion.

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

Entfernt alle Elemente, die den Schlüssel key haben, aus der Karte. Gibt die Anzahl der entfernten Elemente zurück, die 1 ist, wenn der Schlüssel in der Karte existiert, und sonst 0.

Siehe auch clear() und take().

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

Entfernt alle Elemente, für die das Prädikat pred den Wert true liefert, aus der Map.

Die Funktion unterstützt Prädikate, die entweder ein Argument vom Typ QMap<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().

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

Gibt die Anzahl der (Schlüssel, Wert) Paare in der Map zurück.

Siehe auch isEmpty() und count().

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

Tauscht diese Karte mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

T QMap::take(const Key &key)

Entfernt das Element mit dem Schlüssel key aus der Map und gibt den dazugehörigen Wert zurück.

Wenn das Element nicht in der Map vorhanden ist, gibt die Funktion einfach einen standardmäßig konstruierten Wert zurück.

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

Siehe auch remove().

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

Gibt eine STL-Map zurück, die dieser QMap entspricht.

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

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Gibt einen Iterator zurück, der auf das Element zeigt, das unmittelbar auf das letzte Element mit dem Schlüssel key in der Map folgt. Wenn die Map kein Element mit dem Schlüssel key enthält, gibt die Funktion einen Iterator zurück, der auf das nächstgelegene Element mit einem größeren Schlüssel zeigt.

Beispiel:

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

Siehe auch lowerBound() und find().

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

Dies ist eine überladene Funktion.

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

Gibt den Wert zurück, der mit dem Schlüssel key verknüpft ist.

Wenn die Karte kein Element mit dem Schlüssel key enthält, gibt die Funktion defaultValue zurück. Wenn kein defaultValue angegeben ist, gibt die Funktion einen standardmäßig konstruierten Wert zurück.

Siehe auch key(), values(), contains(), und operator[]().

QList<T> QMap::values() const

Gibt eine Liste zurück, die alle Werte der Map in aufsteigender Reihenfolge ihrer Schlüssel enthält.

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

Siehe auch keys() und value().

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

Verschieben - weist other dieser QMap Instanz zu.

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

Weist dieser Karte other zu und gibt einen Verweis auf diese Karte zurück.

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

Gibt den zum Schlüssel key gehörenden Wert als veränderbaren Verweis zurück.

Wenn die Map kein Element mit dem Schlüssel key enthält, fügt die Funktion einen standardmäßig konstruierten Wert mit dem Schlüssel key in die Map ein und gibt eine Referenz darauf zurück.

Siehe auch insert() und value().

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

Dies ist eine überladene Funktion.

Dasselbe wie value().