Sur cette page

QKeyValueIterator Class

template <typename Key, typename T, typename Iterator, typename Traits = QtPrivate::QDefaultKeyValues<Key, T, Iterator>> class QKeyValueIterator

Itérateur sur les paires clé/valeur d'un conteneur associatif. Plus d'informations...

En-tête : #include <QKeyValueIterator>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Fonctions publiques

QKeyValueIterator()
QKeyValueIterator(Iterator o)
Iterator base() const
std::pair<Key, T> operator*() const
QKeyValueIterator<Key, T, Iterator, Traits> &operator++()
QKeyValueIterator<Key, T, Iterator, Traits> operator++(int)
QKeyValueIterator<Key, T, Iterator, Traits> &operator--()
QKeyValueIterator<Key, T, Iterator, Traits> operator--(int)
QKeyValueIterator<Key, T, Iterator, Traits>::pointer operator->() const
bool operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)
bool operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)

Description détaillée

La classe QKeyValueIterator fournit un itérateur de style STL pour renvoyer des paires clé/valeur à partir de conteneurs associatifs comme QHash et QMap. Elle supporte la même API que les conteneurs associatifs STL, c'est-à-dire l'obtention d'une paire clé/valeur lors de l'itération à travers le conteneur.

Cela permettra une meilleure interopérabilité entre QMap, QHash et leurs amis et les algorithmes de type STL.

Attention : Les itérateurs sur des conteneurs implicitement partagés ne fonctionnent pas exactement comme les itérateurs STL. Vous devez éviter de copier un conteneur lorsque des itérateurs sont actifs sur ce conteneur. Pour plus d'informations, lisez Problème des itérateurs à partage implicite.

Documentation des fonctions membres

QKeyValueIterator::QKeyValueIterator()

Construit un QKeyValueIterator par défaut.

[explicit constexpr noexcept(...)] QKeyValueIterator::QKeyValueIterator(Iterator o)

Construit un QKeyValueIterator au-dessus de o.

Note : Cette fonction est noexcept lorsque std::is_nothrow_move_constructible<Iterator>::value est true.

Iterator QKeyValueIterator::base() const

Renvoie l'itérateur sous-jacent sur lequel QKeyValueIterator est basé.

std::pair<Key, T> QKeyValueIterator::operator*() const

Renvoie l'entrée actuelle sous forme de paire.

QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator++()

L'opérateur préfixe ++ (++i) fait passer l'itérateur à l'élément suivant du conteneur et renvoie l'itérateur.

Note : Avancer l'itérateur au-delà de la fin() de son conteneur constitue un comportement indéfini.

Voir aussi operator--().

QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator++(int)

L'opérateur postfixe ++ (i++) fait passer l'itérateur à l'élément suivant du conteneur et renvoie la valeur précédente de l'itérateur.

Remarque : le fait d'avancer l'itérateur au-delà de la fonction end() de son conteneur constitue un comportement indéfini.

Il s'agit d'une fonction surchargée.

QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator--()

L'opérateur préfixe c{-} (--i) fait reculer l'itérateur jusqu'à l'élément précédent du conteneur et renvoie l'itérateur.

Remarque : le fait de faire reculer un itérateur avant le begin() de son conteneur constitue un comportement indéfini.

Voir également operator++().

QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator--(int)

L'opérateur postfixe c{-} (i--) fait reculer l'itérateur jusqu'à l'élément précédent du conteneur et renvoie la valeur précédente de l'itérateur.

Remarque : le fait de faire reculer un itérateur avant le begin() de son conteneur constitue un comportement indéfini.

Il s'agit d'une fonction surchargée.

QKeyValueIterator<Key, T, Iterator, Traits>::pointer QKeyValueIterator::operator->() const

Renvoie l'entrée actuelle sous la forme d'un objet de type pointeur vers la paire.

Voir également operator*().

Non-membres apparentés

[noexcept] bool operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)

Renvoie true si rhs pointe vers un élément différent de lhs, sinon renvoie false.

Voir aussi operator==().

[noexcept] bool operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)

Renvoie true si rhs pointe vers le même élément que lhs sinon renvoie false.

Voir aussi operator!=().

© 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.