QMap Class

Dokumentation zu den Member-Funktionen

[default] QMap::QMap()

Erstellt eine leere Zuordnung.

Siehe auch „ clear()“.

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

Erstellt eine Kopie von „ other “.

Siehe auch toStdMap().

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

Erstellt eine Map mit einer Kopie jedes Elements aus der Initialisierungsliste „ list “.

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

Erstellt eine Karte, indem die Daten von other abgerufen werden.

Siehe auch toStdMap().

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

Erstellt eine Kopie von other.

Dieser Vorgang erfolgt in konstanter Zeit, da QMap implizit gemeinsam genutzt wird. Dadurch ist die Rückgabe eines QMap aus einer Funktion sehr schnell. Wird eine gemeinsam genutzte Instanz geändert, wird sie kopiert (Copy-on-Write), was lineare Zeit in Anspruch nimmt.

Siehe auch operator=.

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

Erstellt eine QMap-Instanz mit der „Move“-Konstruktion.

[implicit] QMap::~QMap()

Löscht die Map. Verweise auf die Werte in der Map sowie alle Iteratoren über diese Map werden ungültig.

Gibt ein Range-Objekt zurück, das die Iteration über diese Map als Schlüssel-Wert-Paare ermöglicht. Dieses Range-Objekt kann beispielsweise in einer Range-basierten 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 abgerufen werden, Verweise auf die entsprechenden Elemente in der Map sind. Das bedeutet konkret, dass eine Änderung des Werts die Map selbst verändert.

Diese Funktionen wurden in Qt 6.4 eingeführt.

Siehe auch QKeyValueIterator.

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

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

Siehe auch „ constBegin()“ und „ end()“.

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

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

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

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

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

Gibt einen konstanten Iterator im STL-Stil zurück, der auf das imaginäre Element nach dem letzten Element im Map 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 konstanten Iterator im STL-Stil zurück, der auf das erste Element im Map zeigt.

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

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

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

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 “ im Map verweist.

Enthält die Map keinen Eintrag mit dem Schlüssel „ key “, gibt die Funktion „ constEnd()“ zurück.

Siehe auch ` find()`.

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

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

Siehe auch ` keyValueBegin()`.

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

Gibt einen konstanten Iterator im STL-Stil 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 Map einen Eintrag 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 Elemente zurück, die dem Schlüssel „ key “ zugeordnet sind.

Siehe auch contains().

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

Entspricht „ size()“.

bool QMap::empty() const

Diese Funktion dient der STL-Kompatibilität. Sie entspricht der Funktion „ isEmpty()“ und gibt „true“ zurück, wenn die Map 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 Map zeigt.

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

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

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

Gibt ein Iteratorpaar zurück, das den Wertebereich [first, second) begrenzt, der unter key gespeichert ist.

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

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

Entfernt das (Schlüssel, Wert)-Paar, auf das der Iterator pos zeigt, aus der Map und gibt einen Iterator auf das nächste 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 (Schlüssel, Wert)-Paare, auf die der Iteratorbereich [first, last) verweist, aus der Map. Gibt einen Iterator auf das Element in der Map zurück, das auf das zuletzt 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 “ im Map verweist.

Enthält die Map keinen Eintrag mit dem Schlüssel „ key “, 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

T &QMap::first()

Gibt eine Referenz auf den ersten Wert im Map zurück, d. h. den Wert, der dem kleinsten Schlüssel zugeordnet ist. Diese Funktion setzt voraus, dass der Map nicht leer ist.

Wenn die Funktion nicht gemeinsam genutzt wird (oder die „const“-Version aufgerufen wird), wird dies in konstanter Zeit ausgeführt.

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

const T &QMap::first() const

const Key &QMap::firstKey() const

Gibt eine Referenz auf den kleinsten Schlüssel im Map zurück. Diese Funktion setzt voraus, dass der Map nicht leer ist.

Die Ausführung erfolgt in konstanter Zeit.

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 in beiden Maps vorkommt, wird sein Wert durch den in „ map “ gespeicherten Wert ersetzt.

Wenn „ map “ gemeinsam genutzt wird, werden die Einträge stattdessen kopiert.

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

Fügt alle Elemente aus „ 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 einen neuen Eintrag mit dem Schlüssel „ key “ und dem Wert „ value “ ein.

Wenn bereits ein Eintrag mit dem Schlüssel „ key “ vorhanden ist, wird dessen Wert durch „ value “ ersetzt.

Das Einfügen eines Schlüssel-Wert-Paares mit einem bereits vorhandenen Schlüssel ersetzt den bestehenden Wert.

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

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

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

Wird constBegin() als Hinweis verwendet, bedeutet dies, dass key kleiner ist als jeder Schlüssel in der Map, während constEnd() angibt, dass key (streng) größer ist als jeder Schlüssel in der Map. Andernfalls sollte der Hinweis die Bedingung (pos - 1) erfüllen:key() < key <= pos.key(). Ist der Hinweis pos falsch, wird er ignoriert und ein regulärer Einfügevorgang durchgeführt.

Wenn bereits ein Element mit dem Schlüssel key vorhanden ist, wird dessen Wert durch value ersetzt.

Ist der Hinweis korrekt und ist das Map nicht gemeinsam genutzt, erfolgt das Einfügen in amortisierter konstanter Zeit.

Beim Erstellen 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 (was benötigt wird, um zu prüfen, ob der Hinweis gültig ist) logarithmische Zeit benötigt.

Hinweis: Seien Sie vorsichtig mit dem Hinweis. Die Angabe eines Iterators aus einer älteren gemeinsam genutzten Instanz kann zu einem Absturz führen, es besteht jedoch auch das Risiko, dass sowohl die Map als auch die ` pos `-Map unbemerkt beschädigt werden.

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

bool QMap::isEmpty() const

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

Siehe auch size().

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

Gibt den ersten Schlüssel mit dem Wert „ value “ zurück oder „ defaultKey “, falls die Map keinen Eintrag mit dem Wert „ value “ enthält. Wird kein „ defaultKey “ angegeben, gibt die Funktion einen standardmäßig konstruierten Schlüssel zurück.

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

Siehe auch value() und keys().

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

Gibt einen konstanten Iterator im STL-Stil zurück, der auf den ersten Schlüssel im Map zeigt.

Siehe auch „ keyEnd()“ und „ firstKey()“.

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

Gibt einen konstanten Iterator im STL-Stil zurück, der auf das imaginäre Element nach dem letzten Schlüssel im Map verweist.

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 im Map verweist.

Siehe auch ` keyValueEnd()`.

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

Gibt einen konstanten Iterator im STL-Stil zurück, der auf den ersten Eintrag im 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 konstanten Iterator im STL-Stil zurück, der auf den imaginären Eintrag nach dem letzten Eintrag im Map zeigt.

Siehe auch ` keyValueBegin()`.

QList<Key> QMap::keys() const

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

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

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

Siehe auch values() und key().

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

Gibt eine Liste zurück, die alle Schlüssel enthält, die mit dem Wert „ value “ verknüpft sind, in aufsteigender Reihenfolge.

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

T &QMap::last()

Gibt eine Referenz auf den letzten Wert im Map zurück, d. h. den Wert, der dem größten Schlüssel zugeordnet ist. Diese Funktion setzt voraus, dass der Map nicht leer ist.

Wenn die Funktion ohne Freigabe aufgerufen wird (oder die „const“-Version), wird sie in konstanter Zeit ausgeführt.

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

const T &QMap::last() const

const Key &QMap::lastKey() const

Gibt eine Referenz auf den größten Schlüssel im Map zurück. Diese Funktion setzt voraus, dass der Map nicht leer ist.

Die Ausführung erfolgt in konstanter Zeit.

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 “ im Map verweist. Enthält der Map kein Element mit dem Schlüssel „ key “, gibt die Funktion einen Iterator auf das nächstgelegene Element mit einem größeren Schlüssel zurück.

Siehe auch upperBound() und find().

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

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

Entfernt alle Elemente, die den Schlüssel „ key “ haben, aus der Map. Gibt die Anzahl der entfernten Elemente zurück; diese beträgt 1, wenn der Schlüssel in der Map vorhanden ist, andernfalls 0.

Siehe auch ` clear()` und ` take()`.

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

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

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 &> “ entgegennehmen.

Gibt die Anzahl der entfernten Elemente zurück, sofern 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)

Ersetzt diese Karte durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

T QMap::take(const Key &key)

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

Wenn der Eintrag in der Map nicht 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 entspricht: QMap.

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

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 verweist, das unmittelbar auf das letzte Element mit dem Schlüssel „ key “ in der Map folgt. Enthält die Map kein Element mit dem Schlüssel „ key “, gibt die Funktion einen Iterator auf das nächstgelegene Element mit einem größeren Schlüssel zurück.

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

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

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

Enthält die Map keinen Eintrag mit dem Schlüssel „ key “, gibt die Funktion „ defaultValue “ zurück. Wird kein „ defaultValue “ angegeben, 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 des Maps in aufsteigender Reihenfolge ihrer Schlüssel enthält.

Diese Funktion erstellt eine neue Liste in linearer Zeit. Der damit verbundene Zeit- und Speicherbedarf lässt sich vermeiden, indem man von ` keyValueBegin()` bis ` keyValueEnd()` durchläuft.

Siehe auch keys() und value().

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

Weist „ other “ dieser „ QMap “-Instanz zu.

[implicit] 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 Wert zurück, der dem Schlüssel „ key “ zugeordnet ist, als bearbeitbare Referenz.

Enthält die Map keinen Eintrag mit dem Schlüssel „ key “, 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

Entspricht „ value()“.