Sur cette page

QAssociativeIterable Class

La classe QAssociativeIterable est une interface itérable pour un conteneur associatif dans un site QVariant. Plus....

En-tête : #include <QAssociativeIterable>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core
Hérite : QIterable
Statut : Jusqu'à la version 6.15

Cette classe est prévue pour être obsolète dans la version 6.15.

Types publics

Fonctions publiques

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

Description détaillée

Utilisez plutôt QMetaAssociation::Iterable.

Cette classe permet plusieurs méthodes d'accès aux éléments d'un conteneur associatif contenu dans un QVariant. Une instance de QAssociativeIterable peut être extraite d'un QVariant s'il peut être converti en QVariantHash ou QVariantMap ou si une vue mutable personnalisée a été enregistrée.

Le conteneur lui-même n'est pas copié avant l'itération.

Voir également QVariant.

Documentation sur les types de membres

[alias] QAssociativeIterable::BidirectionalConstIterator

Expose un const_iterator utilisant std::bidirectional_iterator_tag.

[alias] QAssociativeIterable::BidirectionalIterator

Expose un itérateur utilisant std::bidirectional_iterator_tag.

[alias] QAssociativeIterable::ForwardConstIterator

Expose un const_iterator utilisant std::forward_iterator_tag.

[alias] QAssociativeIterable::ForwardIterator

Expose un itérateur utilisant std::forward_iterator_tag.

[alias] QAssociativeIterable::InputConstIterator

Expose un const_iterator utilisant std::input_iterator_tag.

[alias] QAssociativeIterable::InputIterator

Expose un itérateur utilisant std::input_iterator_tag.

[alias] QAssociativeIterable::RandomAccessConstIterator

Expose un const_iterator utilisant std::random_access_iterator_tag.

[alias] QAssociativeIterable::RandomAccessIterator

Expose un itérateur utilisant std::random_access_iterator_tag.

[alias, until 6.15] QAssociativeIterable::const_iterator

Ce typedef sera obsolète à partir de la version 6.15.

Utilisez QMetaAssociation::Iterable::ConstIterator à la place.

Le QAssociativeIterable::const_iterator permet l'itération sur un conteneur dans un QVariant.

Un QAssociativeIterable::const_iterator ne peut être créé que par une instance QAssociativeIterable, et peut être utilisé de la même manière que les autres itérateurs de style stl.

Voir également QAssociativeIterable.

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

Ce typedef sera obsolète à partir de la version 6.15.

Utilisez QMetaAssociation::Iterable::Iterator à la place.

Le QAssociativeIterable::iterator permet l'itération sur un conteneur dans un QVariant.

Un QAssociativeIterable::iterator ne peut être créé que par une instance QAssociativeIterable, et peut être utilisé de la même manière que les autres itérateurs de style stl.

Ce typedef a été introduit dans Qt 6.0.

Voir aussi QAssociativeIterable.

Documentation des fonctions membres

bool QAssociativeIterable::containsKey(const QVariant &key)

Retourne true si le conteneur a une entrée avec le type donné key, ou false sinon. Si key n'est pas convertible dans le type attendu, false est renvoyé.

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

Récupère un const_iterator pointant vers l'élément à l'adresse key donnée, ou la fin du conteneur si cette clé n'existe pas. Si l'adresse key n'est pas convertible dans le type attendu, la fin du conteneur est renvoyée.

void QAssociativeIterable::insertKey(const QVariant &key)

Insère une nouvelle entrée avec l'adresse key, ou réinitialise la valeur mappée de toute entrée existante avec l'adresse key à la valeur mappée construite par défaut. L'adresse key est contrainte au type attendu : S'il n'est pas convertible, une valeur par défaut est insérée.

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

Récupère un itérateur pointant vers l'élément à l'adresse key, ou vers la fin du conteneur si cette clé n'existe pas. Si l'adresse key n'est pas convertible dans le type attendu, la fin du conteneur est renvoyée.

void QAssociativeIterable::removeKey(const QVariant &key)

Supprime du conteneur l'entrée correspondant à l'adresse key. L'adresse key est convertie au type attendu : S'il n'est pas convertible, la valeur par défaut est supprimée.

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

Définit la valeur mappée associée à key en mapped, si possible. Insère une nouvelle entrée, s'il n'en existe pas encore, pour la valeur key donnée. Si key n'est pas convertible en type de clé, la valeur du type de clé construit par défaut est remplacée.

Voir aussi value().

QVariant QAssociativeIterable::value(const QVariant &key) const

Récupère la valeur mappée à l'adresse key donnée, ou une QVariant construite par défaut du type mappé, si la clé n'existe pas. Si key n'est pas convertible en type de clé, la valeur mappée associée à la clé construite par défaut est renvoyée.

Voir aussi 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.