QCborMap::Iterator Class
class QCborMap::IteratorLa classe ` QCborMap::Iterator ` fournit un itérateur non-const de type STL pour ` QCborMap`. En savoir plus…
- Liste de tous les membres, y compris les membres hérités
- L'itérateur fait partie du support CBOR dans Qt.
Comparaisons de QCborMap::Iterator
| Catégorie | Types comparables |
|---|---|
| strong | QCborMap::Iterator |
| strong | ConstIterator. |
Types publics
Fonctions publiques
| Iterator() | |
| Iterator(const QCborMap::Iterator &other) | |
| ~Iterator() | |
| QCborValue | key() const |
| QCborValueRef | value() const |
| QCborMap::Iterator::value_type | operator*() const |
| QCborMap::Iterator | operator+(qsizetype j) const |
| QCborMap::Iterator & | operator++() |
| QCborMap::Iterator | operator++(int) |
| QCborMap::Iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QCborMap::Iterator j) const |
| QCborMap::Iterator | operator-(qsizetype j) const |
| QCborMap::Iterator & | operator--() |
| QCborMap::Iterator | operator--(int) |
| QCborMap::Iterator & | operator-=(qsizetype j) |
| const QCborValueConstRef * | operator->() const |
| QCborMap::Iterator & | operator=(const QCborMap::Iterator &other) |
Éléments non membres associés
| bool | operator!=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs) |
| bool | operator!=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs) |
| bool | operator<(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs) |
| bool | operator<(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs) |
| bool | operator<=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs) |
| bool | operator<=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs) |
| bool | operator==(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs) |
| bool | operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs) |
| bool | operator>(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs) |
| bool | operator>(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs) |
| bool | operator>=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs) |
| bool | operator>=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs) |
Description détaillée
QCborMap::Iterator vous permet de parcourir un QCborMap et de modifier la valeur (mais pas la clé) stockée sous une clé particulière. Si vous souhaitez parcourir un `const QCborMap`, vous devez utiliser ` QCborMap::ConstIterator`. Il est généralement recommandé d’utiliser ` QCborMap::ConstIterator ` sur un ` QCborMap ` non constant également, sauf si vous devez modifier l’ QCborMap via l’itérateur. Les itérateurs constants sont légèrement plus rapides et améliorent la lisibilité du code.
Vous devez initialiser l’itérateur à l’aide d’une fonction de type QCborMap telle que QCborMap::begin(), QCborMap::end() ou QCborMap::find() avant de pouvoir commencer l’itération.
Il est possible d’utiliser plusieurs itérateurs sur un même objet. Les itérateurs existants deviendront toutefois « pendants » dès que l’objet sera modifié.
Voir également QCborMap::ConstIterator.
Documentation sur les types de membres
Iterator::iterator_category
Synonyme de std::random_access_iterator_tag indiquant que cet itérateur est un itérateur à accès aléatoire.
Documentation des fonctions membres
[constexpr noexcept default] Iterator::Iterator()
Crée un itérateur non initialisé.
Les fonctions telles que key(), value() et l'opérateur++() ne doivent pas être appelées sur un itérateur non initialisé. Utilisez l'opérateur=() pour lui attribuer une valeur avant de l'utiliser.
Voir également QCborMap::begin() et QCborMap::end().
[constexpr noexcept default] Iterator::Iterator(const QCborMap::Iterator &other)
Crée un itérateur qui est une copie de other.
[constexpr noexcept default] Iterator::~Iterator()
Supprime l'instance de ` Iterator`.
QCborValue Iterator::key() const
Renvoie la clé de l'élément courant.
Il n'existe pas de moyen direct de modifier la clé d'un élément via un itérateur, bien que cela soit possible en appelant d'abord la fonction ` QCborMap::erase()` puis la fonction ` QCborMap::insert()`.
Voir également value().
QCborValueRef Iterator::value() const
Renvoie une référence modifiable à la valeur de l'élément courant.
Vous pouvez modifier la valeur d'une clé en utilisant la fonction value() à gauche d'une affectation.
La valeur renvoyée est de type QCborValueRef, une classe d'aide pour QCborArray et QCborMap. Lorsque vous obtenez un objet de type QCborValueRef, vous pouvez l'utiliser comme s'il s'agissait d'une référence à un QCborValue. Si vous lui attribuez une valeur, l'affectation s'appliquera à l'élément de QCborArray ou QCborMap à partir duquel vous avez obtenu la référence.
Voir également key() et operator*().
QCborMap::Iterator::value_type Iterator::operator*() const
Renvoie une paire contenant la clé de l'élément actuel et une référence modifiable à la valeur de cet élément.
Le deuxième élément de la paire est de type QCborValueRef, une classe d'aide pour QCborArray et QCborMap. Lorsque vous obtenez un objet de type QCborValueRef, vous pouvez l'utiliser comme s'il s'agissait d'une référence à un QCborValue. Si vous lui attribuez une valeur, l'affectation s'appliquera à l'élément du QCborArray ou du QCborMap à partir duquel vous avez obtenu la référence.
Voir également key() et value().
QCborMap::Iterator Iterator::operator+(qsizetype j) const
Renvoie un itérateur vers l'élément situé à j positions en avant par rapport à cet itérateur. Si j est négatif, l'itérateur se déplace vers l'arrière.
Voir aussi operator-().
QCborMap::Iterator &Iterator::operator++()
L'opérateur préfixe ++, ++i, fait avancer l'itérateur vers l'élément suivant de la carte et renvoie cet itérateur.
L'appel de cette fonction sur ` QCborMap::end()` conduit à des résultats indéfinis.
Voir également operator--().
QCborMap::Iterator Iterator::operator++(int)
L'opérateur d'++ postfixe, i++, fait avancer l'itérateur vers l'élément suivant de la carte et renvoie un itérateur vers l'élément qui était précédemment sélectionné.
Il s'agit d'une fonction surchargée.
QCborMap::Iterator &Iterator::operator+=(qsizetype j)
Fait avancer l'itérateur de j éléments. Si j est négatif, l'itérateur recule. Renvoie une référence à cet itérateur.
Voir également operator-=() et operator+().
qsizetype Iterator::operator-(QCborMap::Iterator j) const
Renvoie la position de l'élément situé à l'j de l'itérateur par rapport à l'élément situé à cet itérateur. Si l'élément situé à l'j se trouve en amont de cet itérateur, la valeur renvoyée est négative.
Voir également operator+().
QCborMap::Iterator Iterator::operator-(qsizetype j) const
Renvoie un itérateur pointant vers l'élément situé à j positions en arrière par rapport à cet itérateur. Si j est une valeur négative, l'itérateur se déplace vers l'avant.
Voir également operator+().
QCborMap::Iterator &Iterator::operator--()
L'opérateur préfixe « -- », --i, désigne l'élément précédent comme élément courant et renvoie cet itérateur.
L'appel de cette fonction sur QCborMap::begin() donne lieu à des résultats indéfinis.
Voir aussi operator++().
QCborMap::Iterator Iterator::operator--(int)
L'opérateur postfixe « -- », i--, désigne l'élément précédent comme élément courant et renvoie un itérateur pointant vers l'élément qui était auparavant l'élément courant.
Il s'agit d'une fonction surchargée.
QCborMap::Iterator &Iterator::operator-=(qsizetype j)
Fait reculer l'itérateur de j éléments. Si j est négatif, l'itérateur avance. Renvoie une référence à cet itérateur.
Voir également operator+=() et operator-().
const QCborValueConstRef *Iterator::operator->() const
Renvoie un pointeur vers une référence modifiable à la valeur de la paire actuelle.
QCborMap::Iterator &Iterator::operator=(const QCborMap::Iterator &other)
Fait de cet itérateur une copie de other et renvoie une référence à cet itérateur.
Éléments non membres associés
[noexcept] bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
[noexcept] bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers une entrée de la carte différente de celle indiquée par l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir également operator==().
[noexcept] bool operator<(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
[noexcept] bool operator<(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
Renvoie « true » si l'élément de la carte pointé par l'itérateur « lhs » apparaît avant l'élément pointé par l'itérateur « rhs ».
[noexcept] bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
[noexcept] bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
Renvoie ` true ` si l'entrée de la carte pointée par l'itérateur ` lhs ` précède ou correspond à celle pointée par l'itérateur ` rhs `.
[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers la même entrée de la carte que l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir aussi operator!=().
[noexcept] bool operator>(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
[noexcept] bool operator>(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
Renvoie ` true ` si l'entrée de la carte pointée par l'itérateur ` lhs ` se trouve après l'entrée pointée par l'itérateur ` rhs `.
[noexcept] bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
[noexcept] bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
Renvoie ` true ` si l'entrée de la carte pointée par l'itérateur ` lhs ` se trouve après l'entrée pointée par l'itérateur ` rhs ` ou s'il s'agit de la même entrée.
© 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.
