Auf dieser Seite

QAssociativeIterable Class

Die Klasse QAssociativeIterable ist eine iterierbare Schnittstelle für einen assoziativen Container in einem QVariant. ...

Kopfzeile: #include <QAssociativeIterable>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Vererbt: QIterable
Status: Bis 6.15

Diese Klasse wird voraussichtlich in Version 6.15 veraltet sein.

Öffentliche Typen

Ö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

Detaillierte Beschreibung

Verwenden Sie stattdessen QMetaAssociation::Iterable.

Diese Klasse ermöglicht mehrere Methoden des Zugriffs auf die Elemente eines assoziativen Containers, der sich in einem QVariant befindet. Eine Instanz von QAssociativeIterable kann aus einem QVariant extrahiert werden, wenn sie in ein QVariantHash oder QVariantMap konvertiert werden kann oder wenn eine benutzerdefinierte veränderbare Ansicht registriert wurde.

Der Container selbst wird nicht kopiert, bevor über ihn iteriert wird.

Siehe auch QVariant.

Dokumentation der Mitgliedstypen

[alias] QAssociativeIterable::BidirectionalConstIterator

Zeigt eine const_iterator mit std::bidirectional_iterator_tag an.

[alias] QAssociativeIterable::BidirectionalIterator

Stellt einen Iterator mit std::bidirectional_iterator_tag dar.

[alias] QAssociativeIterable::ForwardConstIterator

Zeigt eine const_iterator mit std::forward_iterator_tag an.

[alias] QAssociativeIterable::ForwardIterator

Stellt einen Iterator mit std::forward_iterator_tag dar.

[alias] QAssociativeIterable::InputConstIterator

Zeigt eine const_iterator mit std::input_iterator_tag an.

[alias] QAssociativeIterable::InputIterator

Stellt einen Iterator mit std::input_iterator_tag dar.

[alias] QAssociativeIterable::RandomAccessConstIterator

Zeigt eine const_iterator mit std::random_access_iterator_tag an.

[alias] QAssociativeIterable::RandomAccessIterator

Zeigt einen Iterator mit std::random_access_iterator_tag an.

[alias, until 6.15] QAssociativeIterable::const_iterator

Dieser Typedef soll in Version 6.15 veraltet sein.

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 kann auf ähnliche Weise wie andere stl-style Iteratoren verwendet werden.

Siehe auch QAssociativeIterable.

[alias, since 6.0, until 6.15] QAssociativeIterable::iterator

Dieser Typedef soll in Version 6.15 veraltet sein.

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 kann auf ähnliche Weise wie andere stl-style Iteratoren verwendet werden.

Dieser Typedef wurde in Qt 6.0 eingeführt.

Siehe auch QAssociativeIterable.

Dokumentation der Mitgliedsfunktionen

bool QAssociativeIterable::containsKey(const QVariant &key)

Gibt true zurück, wenn der Container einen Eintrag mit dem angegebenen key hat, andernfalls false. Wenn key nicht in den erwarteten Typ konvertierbar ist, wird false zurückgegeben.

QAssociativeIterable::const_iterator QAssociativeIterable::find(const QVariant &key) const

Ruft eine const_iterator ab, die auf das Element mit dem angegebenen key zeigt, oder das Ende des Containers, wenn dieser Schlüssel nicht existiert. Wenn der key nicht in den erwarteten Typ konvertierbar ist, 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 vorhandenen Eintrags mit dem angegebenen key auf den standardmäßig konstruierten zugeordneten Wert zurück. Der key wird in den erwarteten Typ umgewandelt: Wenn er nicht konvertierbar ist, wird ein Standardwert eingefügt.

QAssociativeIterable::iterator QAssociativeIterable::mutableFind(const QVariant &key)

Ruft einen Iterator ab, der auf das Element mit dem angegebenen key zeigt, oder auf das Ende des Containers, wenn dieser Schlüssel nicht existiert. Wenn key nicht in den erwarteten Typ konvertierbar ist, wird das Ende des Containers zurückgegeben.

void QAssociativeIterable::removeKey(const QVariant &key)

Entfernt den Eintrag mit dem angegebenen key aus dem Container. Der key wird in den erwarteten Typ konvertiert: Wenn er nicht konvertierbar ist, wird der Standardwert entfernt.

void QAssociativeIterable::setValue(const QVariant &key, const QVariant &mapped)

Setzt den mit key verbundenen gemappten Wert auf mapped, falls möglich. Fügt einen neuen Eintrag für den angegebenen key ein, falls noch keiner existiert. Wenn 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 gemappten Wert unter der angegebenen Adresse key ab oder einen standardmäßig konstruierten QVariant des gemappten Typs, falls der Schlüssel nicht existiert. Wenn key nicht in den Schlüsseltyp konvertierbar ist, wird der gemappte Wert, der mit dem standardmäßig konstruierten Schlüssel verbunden ist, 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.