QCborArray::Iterator Class
class QCborArray::IteratorLa classe ` QCborArray::Iterator ` fournit un itérateur non-const de type STL pour ` QCborArray`. 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 QCborArray::Iterator
| Catégorie | Types comparables |
|---|---|
| strong | QCborArray::Iterator |
| strong | QCborArray::ConstIterator. |
Types publics
Fonctions publiques
| Iterator() | |
| Iterator(const QCborArray::Iterator &other) | |
| QCborValueRef | operator*() const |
| QCborArray::Iterator | operator+(qsizetype j) const |
| QCborArray::Iterator & | operator++() |
| QCborArray::Iterator | operator++(int) |
| QCborArray::Iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QCborArray::Iterator other) const |
| QCborArray::Iterator | operator-(qsizetype j) const |
| QCborArray::Iterator & | operator--() |
| QCborArray::Iterator | operator--(int) |
| QCborArray::Iterator & | operator-=(qsizetype j) |
| const QCborValueConstRef * | operator->() const |
| QCborArray::Iterator & | operator=(const QCborArray::Iterator &other) |
| QCborValueRef | operator[](qsizetype j) const |
Éléments non membres associés
| bool | operator!=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator!=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator<(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator<(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator<=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator<=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator==(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator==(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator>(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator>(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator>=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator>=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
Description détaillée
QCborArray::Iterator vous permet de parcourir un tableau QCborArray et de modifier l’élément du tableau associé à l’itérateur. Si vous souhaitez parcourir un tableau const QCborArray, utilisez plutôt QCborArray::ConstIterator. Il est généralement recommandé d’utiliser QCborArray::ConstIterator sur un tableau non const QCborArray également, sauf si vous devez modifier l’ QCborArray via l’itérateur. Les itérateurs const sont légèrement plus rapides et améliorent la lisibilité du code.
Les itérateurs sont initialisés à l’aide d’une fonction de type QCborArray, telle que QCborArray::begin(), QCborArray::end() ou QCborArray::insert(). L’itération n’est possible qu’après cette initialisation.
La plupart des fonctions d'QCborArray acceptent un index entier plutôt qu'un itérateur. C'est pourquoi les itérateurs sont rarement utiles en association avec QCborArray. Les itérateurs de type STL trouvent toutefois leur utilité en tant qu'arguments de generic algorithms.
Il est possible d’utiliser plusieurs itérateurs sur le même tableau. Attention toutefois : tout appel de fonction non `const` effectué sur ` QCborArray ` rendra tous les itérateurs existants indéfinis.
Voir également QCborArray::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 operator*() et operator++() ne doivent pas être appelées sur un itérateur non initialisé. Utilisez operator=() pour lui attribuer une valeur avant de l'utiliser.
Voir également QCborArray::begin() et QCborArray::end().
[constexpr noexcept default] Iterator::Iterator(const QCborArray::Iterator &other)
Crée une copie de other.
QCborValueRef Iterator::operator*() const
Renvoie une référence modifiable vers l'élément actuel.
Vous pouvez modifier la valeur d'un élément en utilisant l'opérateur *() à gauche d'une affectation.
La valeur renvoyée est de type QCborValueRef, une classe auxiliaire 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 l'QCborArray ou QCborMap à partir duquel vous avez obtenu la référence.
QCborArray::Iterator Iterator::operator+(qsizetype j) const
Renvoie un itérateur pointant vers l'élément situé à la position j, en avançant de à partir de cet itérateur. Si j est négatif, l'itérateur recule.
Voir également operator-() et operator+=().
QCborArray::Iterator &Iterator::operator++()
L'opérateur préfixe « ++ », ++it, fait avancer l'itérateur vers l'élément suivant du tableau et renvoie cet itérateur.
L'appel de cette fonction sur QCborArray::end() conduit à des résultats indéfinis.
Voir également operator--().
QCborArray::Iterator Iterator::operator++(int)
L'opérateur d'++ postfixe, it++, fait avancer l'itérateur vers l'élément suivant du tableau et renvoie un itérateur vers l'élément sur lequel se trouvait l'itérateur auparavant.
Il s'agit d'une fonction surchargée.
QCborArray::Iterator &Iterator::operator+=(qsizetype j)
Fait avancer l'itérateur de j positions. 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-(QCborArray::Iterator other) const
Renvoie l'offset de cet itérateur par rapport à other.
QCborArray::Iterator Iterator::operator-(qsizetype j) const
Renvoie un itérateur vers l'élément situé à la position j, en reculant de par rapport à cet itérateur. Si j est négatif, l'itérateur avance.
Voir également operator+() et operator-=().
QCborArray::Iterator &Iterator::operator--()
L'opérateur préfixe « -- », --it, désigne l'élément précédent comme élément courant et renvoie cet itérateur.
L'appel de cette fonction sur QCborArray::begin() conduit à des résultats indéfinis.
Voir également operator++().
QCborArray::Iterator Iterator::operator--(int)
L'opérateur d'-- postfixe, it--, désigne l'élément précédent comme élément actif et renvoie un itérateur vers l'élément qui était auparavant actif.
Il s'agit d'une fonction surchargée.
QCborArray::Iterator &Iterator::operator-=(qsizetype j)
Fait reculer l'itérateur de j positions. 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 pointant vers l'élément actuel.
QCborArray::Iterator &Iterator::operator=(const QCborArray::Iterator &other)
Fait de cet itérateur une copie de other et renvoie une référence à cet itérateur.
QCborValueRef Iterator::operator[](qsizetype j) const
Renvoie une référence modifiable à l'élément situé à une position égale à j pas en avant par rapport à l'élément pointé par cet itérateur.
Cette fonction est fournie pour permettre aux itérateurs d’ QCborArray de se comporter comme des pointeurs C++.
La valeur de retour est de type QCborValueRef, une classe auxiliaire 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 l’ QCborArray ou de l’ QCborMap à partir duquel vous avez obtenu la référence.
Voir également operator+().
Éléments non membres associés
[noexcept] bool operator!=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator!=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers une entrée du tableau différente de celle indiquée par l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir également operator==().
[noexcept] bool operator<(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator<(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Renvoie ` true ` si l'élément du tableau pointé par l'itérateur ` lhs ` se trouve avant l'élément pointé par l'itérateur ` rhs `.
[noexcept] bool operator<=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator<=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Renvoie ` true ` si l'élément du tableau pointé par l'itérateur ` lhs ` précède l'élément pointé par l'itérateur ` rhs ` ou s'il s'agit du même élément.
[noexcept] bool operator==(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator==(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers la même entrée du tableau que l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir également operator!=().
[noexcept] bool operator>(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator>(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Renvoie ` true ` si l'élément du tableau pointé par l'itérateur ` lhs ` se trouve après l'élément pointé par l'itérateur ` rhs `.
[noexcept] bool operator>=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator>=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Renvoie ` true ` si l'élément du tableau pointé par l'itérateur ` lhs ` se trouve après l'élément pointé par l'itérateur ` rhs ` ou s'il s'agit du même élément.
© 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.
