QAssociativeIterable Class
La classe `QAssociativeIterable` est une interface itérable destinée à un conteneur associatif dans un ` QVariant`. En savoir 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 de : | QIterable |
| Statut : | Jusqu'à la version 6.15 |
Cette classe est prévue pour être obsolète dans la version 6.15.
Types publics
| BidirectionalConstIterator | |
| BidirectionalIterator | |
| ForwardConstIterator | |
| ForwardIterator | |
| InputConstIterator | |
| InputIterator | |
| RandomAccessConstIterator | |
| RandomAccessIterator | |
(until 6.15) | const_iterator |
(since 6.0, until 6.15) | iterator |
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 d’accéder de plusieurs façons aux éléments d’un conteneur associatif contenu dans un QVariant. Une instance de QAssociativeIterable peut être extraite d’un QVariant si celui-ci peut être converti en QVariantHash ou en QVariantMap, ou si une vue mutable personnalisée a été enregistrée.
Le conteneur lui-même n’est pas copié avant d’être parcouru.
Voir également QVariant.
Documentation sur les types de membres
[alias] QAssociativeIterable::BidirectionalConstIterator
Expose un ` const_iterator ` à l'aide de `std::bidirectional_iterator_tag`.
[alias] QAssociativeIterable::BidirectionalIterator
Expose un itérateur à l'aide de std::bidirectional_iterator_tag.
[alias] QAssociativeIterable::ForwardConstIterator
Expose un ` const_iterator ` à l'aide de `std::forward_iterator_tag`.
[alias] QAssociativeIterable::ForwardIterator
Expose un itérateur à l'aide de `std::forward_iterator_tag`.
[alias] QAssociativeIterable::InputConstIterator
Expose un objet de type « const_iterator » à l'aide de std::input_iterator_tag.
[alias] QAssociativeIterable::InputIterator
Expose un itérateur à l'aide de std::input_iterator_tag.
[alias] QAssociativeIterable::RandomAccessConstIterator
Expose un objet de type « const_iterator » à l'aide de std::random_access_iterator_tag.
[alias] QAssociativeIterable::RandomAccessIterator
Expose un itérateur à l'aide de std::random_access_iterator_tag.
[alias, until 6.15] QAssociativeIterable::const_iterator
Ce typedef est prévu pour être obsolète à partir de la version 6.15.
Utilisez plutôt ` QMetaAssociation::Iterable::ConstIterator `.
Le `QAssociativeIterable::const_iterator` permet de parcourir un conteneur dans un ` QVariant`.
Un QAssociativeIterable::const_iterator ne peut être créé qu’à partir d’une instance de ` QAssociativeIterable ` et peut être utilisé de manière similaire aux autres itérateurs de type STL.
Voir également QAssociativeIterable.
[alias, since 6.0, until 6.15] QAssociativeIterable::iterator
Ce `typedef` devrait être obsolète à partir de la version 6.15.
Utilisez plutôt ` QMetaAssociation::Iterable::Iterator `.
L'itérateur `QAssociativeIterable::iterator` permet de parcourir un conteneur dans un ` QVariant`.
Un itérateur QAssociativeIterable::iterator ne peut être créé qu’à partir d’une instance de ` QAssociativeIterable ` et s’utilise de manière similaire aux autres itérateurs de type STL.
Ce typedef a été introduit dans Qt 6.0.
Voir également QAssociativeIterable.
Documentation des fonctions membres
bool QAssociativeIterable::containsKey(const QVariant &key)
Renvoie ` true ` si le conteneur contient une entrée correspondant à l'key` indiquée, ou ` false ` dans le cas contraire. Si l'key ` n'est pas convertible vers le type attendu, la valeur ` false ` est renvoyée.
QAssociativeIterable::const_iterator QAssociativeIterable::find(const QVariant &key) const
Récupère un objet ` const_iterator ` pointant vers l'élément situé à l'key` indiquée, ou vers la fin du conteneur si cette clé n'existe pas. Si l'key n'est pas convertible vers le type attendu, la fin du conteneur est renvoyée.
void QAssociativeIterable::insertKey(const QVariant &key)
Insère une nouvelle entrée avec l’ key spécifiée, ou réinitialise la valeur mappée de toute entrée existante avec l’ key spécifiée à la valeur mappée construite par défaut. L’ key est convertie au type attendu : si elle 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 situé à l'key indiquée, ou vers la fin du conteneur si cette clé n'existe pas. Si l'key n'est pas convertible vers le type attendu, c'est la fin du conteneur qui est renvoyée.
void QAssociativeIterable::removeKey(const QVariant &key)
Supprime de l’objet l’entrée dont l’ key est spécifiée. L’ key est convertie au type attendu : si elle 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 sur mapped, si possible. Insère une nouvelle entrée si aucune n'existe encore, pour l'key donnée. Si l'key n'est pas convertible vers le type de clé, la valeur du type de clé construite par défaut est écrasée.
Voir également value().
QVariant QAssociativeIterable::value(const QVariant &key) const
Récupère la valeur mappée associée à l'key donnée, ou un objet QVariant de type mappé instancié par défaut, si la clé n'existe pas. Si l'key n'est pas convertible vers le type de la clé, la valeur mappée associée à la clé instanciée par défaut est renvoyée.
Voir également 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.
