QAssociativeIterable Class
Die Klasse „QAssociativeIterable“ ist eine iterierbare Schnittstelle für einen assoziativen Container in einem „ QVariant “. Mehr...
| Header: | #include <QAssociativeIterable> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Erbt von: | QIterable |
| Status: | Bis 6.15 |
Diese Klasse soll in Version 6.15 als veraltet markiert werden.
Öffentliche Typen
| BidirectionalConstIterator | |
| BidirectionalIterator | |
| ForwardConstIterator | |
| ForwardIterator | |
| InputConstIterator | |
| InputIterator | |
| RandomAccessConstIterator | |
| RandomAccessIterator | |
(until 6.15) | const_iterator |
(since 6.0, until 6.15) | iterator |
Öffentliche Funktionen
| bool | containsKey(const QVariant &key) |
| QAssociativeIterable::const_iterator | find(const QVariant &key) const |
| void | insertKey(const QVariant &key) |
| QAssociativeIterable::iterator | mutableFind(const QVariant &key) |
| void | removeKey(const QVariant &key) |
| void | setValue(const QVariant &key, const QVariant &mapped) |
| QVariant | value(const QVariant &key) const |
Ausführliche Beschreibung
Verwenden Sie stattdessen „ QMetaAssociation::Iterable “.
Diese Klasse ermöglicht verschiedene Methoden für den Zugriff auf die Elemente eines assoziativen Containers, der in einem „ QVariant “ enthalten ist. Eine Instanz von „QAssociativeIterable“ kann aus einem „ QVariant “ extrahiert werden, wenn dieser in einen „ QVariantHash “ oder „ QVariantMap “ konvertiert werden kann oder wenn eine benutzerdefinierte, veränderbare Ansicht registriert wurde.
Der Container selbst wird vor der Iteration nicht kopiert.
Siehe auch „ QVariant “.
Dokumentation zu Mitgliedstypen
[alias] QAssociativeIterable::BidirectionalConstIterator
Stellt einen „ const_iterator “ mithilfe von „std::bidirectional_iterator_tag“ bereit.
[alias] QAssociativeIterable::BidirectionalIterator
Stellt einen Iterator mithilfe von std::bidirectional_iterator_tag bereit.
[alias] QAssociativeIterable::ForwardConstIterator
Stellt einen „ const_iterator “ mithilfe von „std::forward_iterator_tag“ bereit.
[alias] QAssociativeIterable::ForwardIterator
Stellt einen Iterator mithilfe von `std::forward_iterator_tag` bereit.
[alias] QAssociativeIterable::InputConstIterator
Stellt einen „ const_iterator “ mithilfe von „std::input_iterator_tag“ bereit.
[alias] QAssociativeIterable::InputIterator
Stellt einen Iterator mithilfe von std::input_iterator_tag bereit.
[alias] QAssociativeIterable::RandomAccessConstIterator
Stellt einen „ const_iterator “ mithilfe von „std::random_access_iterator_tag“ bereit.
[alias] QAssociativeIterable::RandomAccessIterator
Stellt einen Iterator mithilfe von std::random_access_iterator_tag bereit.
[alias, until 6.15] QAssociativeIterable::const_iterator
Dieses `typedef` soll ab Version 6.15 als veraltet gelten.
Verwenden Sie stattdessen „ QMetaAssociation::Iterable::ConstIterator “.
Der `QAssociativeIterable::const_iterator` ermöglicht die Iteration über einen Container in einem ` QVariant`.
Ein `QAssociativeIterable::const_iterator` kann nur von einer ` QAssociativeIterable `-Instanz erstellt werden und lässt sich ähnlich wie andere Iteratoren im STL-Stil verwenden.
Siehe auch „ QAssociativeIterable “.
[alias, since 6.0, until 6.15] QAssociativeIterable::iterator
Dieses `typedef` soll in Version 6.15 als veraltet markiert werden.
Verwenden Sie stattdessen „ QMetaAssociation::Iterable::Iterator “.
Der `QAssociativeIterable::iterator` ermöglicht die Iteration über einen Container in einem ` QVariant`.
Ein `QAssociativeIterable::iterator` kann nur von einer ` QAssociativeIterable `-Instanz erstellt werden und lässt sich ähnlich wie andere Iteratoren im STL-Stil verwenden.
Dieser Typedef wurde in Qt 6.0 eingeführt.
Siehe auch „ QAssociativeIterable “.
Dokumentation zu den Mitgliedsfunktionen
bool QAssociativeIterable::containsKey(const QVariant &key)
Gibt „ true “ zurück, wenn der Container einen Eintrag mit dem angegebenen „ key “ enthält, andernfalls „ false “. Wenn der „ key “ nicht in den erwarteten Typ konvertiert werden kann, wird „ false “ zurückgegeben.
QAssociativeIterable::const_iterator QAssociativeIterable::find(const QVariant &key) const
Ruft einen ` const_iterator ` ab, der auf das Element unter der angegebenen ` key` verweist, oder auf das Ende des Containers, falls dieser Schlüssel nicht existiert. Wenn die ` key ` nicht in den erwarteten Typ konvertiert werden kann, wird das Ende des Containers zurückgegeben.
void QAssociativeIterable::insertKey(const QVariant &key)
Fügt einen neuen Eintrag mit dem angegebenen „ key “ ein oder setzt den zugeordneten Wert eines bestehenden Eintrags mit dem angegebenen „ key “ auf den standardmäßig erzeugten zugeordneten Wert zurück. Der „ key “ wird in den erwarteten Typ umgewandelt: Ist er nicht konvertierbar, wird ein Standardwert eingefügt.
QAssociativeIterable::iterator QAssociativeIterable::mutableFind(const QVariant &key)
Ruft einen Iterator ab, der auf das Element unter dem angegebenen Schlüssel ` key` verweist, oder auf das Ende des Containers, falls dieser Schlüssel nicht vorhanden ist. Wenn der Schlüssel ` key ` nicht in den erwarteten Typ konvertiert werden kann, wird das Ende des Containers zurückgegeben.
void QAssociativeIterable::removeKey(const QVariant &key)
Entfernt den Eintrag mit der angegebenen key aus dem Container. Die key wird in den erwarteten Typ umgewandelt: Ist sie nicht konvertierbar, wird der Standardwert entfernt.
void QAssociativeIterable::setValue(const QVariant &key, const QVariant &mapped)
Setzt den zu key gehörenden zugeordneten Wert auf mapped, sofern möglich. Fügt einen neuen Eintrag für den angegebenen key ein, falls noch keiner vorhanden ist. Wenn der key nicht in den Schlüsseltyp konvertierbar ist, wird der Wert für den standardmäßig konstruierten Schlüsseltyp überschrieben.
Siehe auch value().
QVariant QAssociativeIterable::value(const QVariant &key) const
Ruft den zugeordneten Wert unter der angegebenen Schlüsseladresse ` key` ab oder, falls der Schlüssel nicht existiert, ein standardmäßig initialisiertes ` QVariant ` des zugeordneten Typs. Wenn die Schlüsseladresse ` key ` nicht in den Schlüsseltyp konvertierbar ist, wird der dem standardmäßig initialisierten Schlüssel zugeordnete Wert zurückgegeben.
Siehe auch setValue().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
