QJsonArray::iterator Class
class QJsonArray::iteratorLa classe ` QJsonArray::iterator ` fournit un itérateur non-const de type STL pour ` QJsonArray`. En savoir plus...
Comparaisons de QJsonArray::iterator
| Catégorie | Types comparables |
|---|---|
| strong | QJsonArray::iterator |
| strong | QJsonArray::const_iterator. |
Types publics
Fonctions publiques
| iterator() | |
| iterator(const QJsonArray::iterator &other) | |
| QJsonValueRef | operator*() const |
| QJsonArray::iterator | operator+(qsizetype j) const |
| QJsonArray::iterator & | operator++() |
| QJsonArray::iterator | operator++(int) |
| QJsonArray::iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QJsonArray::iterator other) const |
| QJsonArray::iterator | operator-(qsizetype j) const |
| QJsonArray::iterator & | operator--() |
| QJsonArray::iterator | operator--(int) |
| QJsonArray::iterator & | operator-=(qsizetype j) |
| const QJsonValueConstRef * | operator->() const |
| QJsonValueRef | operator[](qsizetype j) const |
Éléments non membres associés
| bool | operator!=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator!=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator<(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator<(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator<=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator<=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator==(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator==(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator>(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator>(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
| bool | operator>=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs) |
| bool | operator>=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs) |
Description détaillée
QJsonArray::iterator vous permet de parcourir un tableau QJsonArray et de modifier l'élément du tableau associé à l'itérateur. Si vous souhaitez parcourir un tableau const QJsonArray, utilisez plutôt QJsonArray::const_iterator. Il est généralement recommandé d'utiliser QJsonArray::const_iterator sur un tableau non const QJsonArray également, sauf si vous devez modifier l'QJsonArray via l'itérateur. Les itérateurs const sont légèrement plus rapides et améliorent la lisibilité du code.
Le constructeur par défaut de ` QJsonArray::iterator ` crée un itérateur non initialisé. Vous devez l’initialiser à l’aide d’une fonction ` QJsonArray ` telle que ` QJsonArray::begin()`, ` QJsonArray::end()` ou ` QJsonArray::insert()` avant de pouvoir commencer l’itération.
QJsonArrayLa plupart des fonctions de type « QJsonArray » acceptent un index entier plutôt qu’un itérateur. C’est pourquoi les itérateurs sont rarement utiles en association avec ces fonctions. Les itérateurs de type STL trouvent toutefois leur utilité en tant qu’arguments de la fonction generic algorithms.
Il est possible d’utiliser plusieurs itérateurs sur le même tableau. Notez toutefois que tout appel de fonction non const effectué sur l’ QJsonArray rendra tous les itérateurs existants indéfinis.
Voir également QJsonArray::const_iterator.
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
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 QJsonArray::begin() et QJsonArray::end().
[constexpr noexcept default] iterator::iterator(const QJsonArray::iterator &other)
Crée une instance de ` iterator` par copie.
QJsonValueRef 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 ` QJsonValueRef`, une classe auxiliaire pour ` QJsonArray ` et ` QJsonObject`. Lorsque vous obtenez un objet de type ` QJsonValueRef`, vous pouvez l'utiliser comme s'il s'agissait d'une référence à un ` QJsonValue`. Si vous lui attribuez une valeur, l'affectation s'appliquera au caractère situé à l'QJsonArray ` de ` QJsonObject ` à partir duquel vous avez obtenu la référence.
QJsonArray::iterator iterator::operator+(qsizetype j) const
Renvoie un itérateur pointant vers l'élément situé à j positions en avant par rapport à cet itérateur. Si j est une valeur négative, l'itérateur se déplace vers l'arrière.
Voir également operator-() et operator+=().
QJsonArray::iterator &iterator::operator++()
L'opérateur préfixe « ++ », ++it, fait avancer l'itérateur vers l'élément suivant du tableau et renvoie un itérateur pointant vers le nouvel élément courant.
L'appel de cette fonction sur ` QJsonArray::end()` conduit à des résultats indéfinis.
Voir également operator--().
QJsonArray::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 pointant vers l'élément sur lequel il se trouvait précédemment.
Il s'agit d'une fonction surchargée.
QJsonArray::iterator &iterator::operator+=(qsizetype j)
Fait avancer l'itérateur de j éléments. Si j est négatif, l'itérateur recule.
Voir également operator-=() et operator+().
qsizetype iterator::operator-(QJsonArray::iterator other) const
Renvoie le nombre d'éléments situés entre l'élément pointé par other et celui pointé par cet itérateur.
QJsonArray::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 négatif, l'itérateur se déplace vers l'avant.
Voir également operator+() et operator-=().
QJsonArray::iterator &iterator::operator--()
L'opérateur préfixe « -- », --it, définit l'élément précédent comme élément courant et renvoie un itérateur vers ce nouvel élément courant.
L'appel de cette fonction sur ` QJsonArray::begin()` conduit à des résultats indéfinis.
Voir également operator++().
QJsonArray::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.
QJsonArray::iterator &iterator::operator-=(qsizetype j)
Fait reculer l'itérateur de j éléments. Si j est négatif, l'itérateur avance.
Voir également operator+=() et operator-().
const QJsonValueConstRef *iterator::operator->() const
Renvoie un pointeur vers une référence modifiable pointant vers l'élément actuel.
QJsonValueRef iterator::operator[](qsizetype j) const
Renvoie une référence modifiable à l'élément situé à l'offset j à partir de l'élément pointé par cet itérateur (l'élément situé à la position *this + j).
Cette fonction est fournie pour permettre aux itérateurs QJsonArray de se comporter comme des pointeurs C++.
La valeur de retour est de type QJsonValueRef, une classe auxiliaire pour QJsonArray et QJsonObject. Lorsque vous obtenez un objet de type QJsonValueRef, vous pouvez l’utiliser comme s’il s’agissait d’une référence à un QJsonValue. Si vous lui attribuez une valeur, l’affectation s’appliquera à l’élément de la QJsonArray ou de la QJsonObject à partir de laquelle vous avez obtenu la référence.
Voir également operator+().
Éléments non membres associés
[noexcept] bool operator!=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator!=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers un élément différent de celui indiqué par l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir aussi operator==().
[noexcept] bool operator<(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator<(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Renvoie « true » si l'élément pointé par l'itérateur « lhs » est antérieur à l'élément pointé par l'itérateur « rhs ».
[noexcept] bool operator<=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator<=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Renvoie ` true ` si l'élément pointé par l'itérateur ` lhs ` est inférieur ou égal à l'élément pointé par l'itérateur ` rhs `.
[noexcept] bool operator==(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator==(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers le même élément que l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir également operator!=().
[noexcept] bool operator>(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator>(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Renvoie « true » si l'élément pointé par l'itérateur lhs est supérieur à l'élément pointé par l'itérateur rhs.
[noexcept] bool operator>=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)
[noexcept] bool operator>=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)
Renvoie ` true ` si l'élément pointé par l'itérateur ` lhs ` est supérieur ou égal à l'élément pointé par l'itérateur ` rhs `.
© 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.
