Sur cette page

QJsonArray::iterator Class

class QJsonArray::iterator

La classe QJsonArray::iterator fournit un itérateur non-const de style STL pour QJsonArray. Plus d'informations...

Cette classe est fortement comparable.

Cette classe est fortement comparable à QJsonArray::const_iterator.

Types publics

Fonctions publiques

iterator()
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
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 permet d'itérer sur un QJsonArray et de modifier l'élément de tableau associé à l'itérateur. Si vous souhaitez itérer sur un const QJsonArray, utilisez plutôt QJsonArray::const_iterator. Il est généralement conseillé d'utiliser QJsonArray::const_iterator sur un QJsonArray non constant, à moins que vous n'ayez besoin de modifier le QJsonArray par l'intermédiaire de 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 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.

La plupart des fonctions QJsonArray acceptent un index entier plutôt qu'un itérateur. C'est pourquoi les itérateurs sont rarement utiles dans le cadre de QJsonArray. Les itérateurs de type STL sont utiles en tant qu'arguments de generic algorithms.

Plusieurs itérateurs peuvent être utilisés sur le même tableau. Cependant, il faut savoir que tout appel de fonction non-const effectué sur 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()

Construit 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 aussi QJsonArray::begin() et QJsonArray::end().

QJsonValueRef iterator::operator*() const

Renvoie une référence modifiable à l'élément courant.

Vous pouvez modifier la valeur d'un élément en utilisant l'opérateur*() du côté gauche d'une affectation.

La valeur de retour est de type QJsonValueRef, une classe d'aide 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 objet QJsonValue. Si vous l'assignez, l'assignation s'appliquera au caractère dans le QJsonArray de QJsonObject à partir duquel vous avez obtenu la référence.

QJsonArray::iterator iterator::operator+(qsizetype j) const

Renvoie un itérateur vers l'élément situé à j positions en avant de cet itérateur. Si j est négatif, l'itérateur revient en arrière.

Voir aussi operator-() et operator+=().

QJsonArray::iterator &iterator::operator++()

L'opérateur préfixe ++, ++it, fait passer l'itérateur à l'élément suivant du tableau et renvoie un itérateur vers le nouvel élément courant.

L'appel de cette fonction sur QJsonArray::end() conduit à des résultats indéfinis.

Voir aussi operator--().

QJsonArray::iterator iterator::operator++(int)

L'opérateur postfixe ++, it++, fait passer l'itérateur à l'élément suivant du tableau et renvoie un itérateur à l'élément courant précédent.

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

QJsonArray::iterator &iterator::operator+=(qsizetype j)

Avance 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 entre l'élément pointé par other et l'élément pointé par cet itérateur.

QJsonArray::iterator iterator::operator-(qsizetype j) const

Renvoie un itérateur vers l'élément situé à j positions en arrière de cet itérateur. Si j est négatif, l'itérateur avance.

Voir aussi operator+() et operator-=().

QJsonArray::iterator &iterator::operator--()

L'opérateur préfixe --, --it, rend l'élément précédent courant et renvoie un itérateur vers le nouvel élément courant.

L'appel de cette fonction sur QJsonArray::begin() conduit à des résultats indéfinis.

Voir aussi operator++().

QJsonArray::iterator iterator::operator--(int)

L'opérateur postfixe --, it--, rend l'élément précédent courant et renvoie un itérateur vers l'élément courant précédent.

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 aussi operator+=() et operator-().

const QJsonValueConstRef *iterator::operator->() const

Renvoie un pointeur sur une référence modifiable de l'élément en cours.

QJsonValueRef iterator::operator[](qsizetype j) const

Renvoie une référence modifiable à l'élément situé à l'offset j de l'élément pointé par cet itérateur (l'élément situé à la position *this + j).

Cette fonction est fournie pour que les itérateurs QJsonArray se comportent comme des pointeurs C++.

La valeur de retour est de type QJsonValueRef, une classe d'aide 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 l'affectez, l'affectation s'appliquera à l'élément du QJsonArray ou du QJsonObject à partir duquel vous avez obtenu la référence.

Voir également operator+().

Non-membres apparentés

[noexcept] bool operator!=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)

[noexcept] bool operator!=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)

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

Voir aussi operator==().

[noexcept] bool operator<(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)

[noexcept] bool operator<(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)

Renvoie true si l'élément désigné par l'itérateur lhs est inférieur à l'élément désigné par l'itérateur rhs.

[noexcept] bool operator<=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)

[noexcept] bool operator<=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)

Renvoie true si l'élément désigné par l'itérateur lhs est inférieur ou égal à l'élément désigné par l'itérateur rhs.

[noexcept] bool operator==(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)

[noexcept] bool operator==(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)

Renvoie true si lhs pointe sur le même élément que l'itérateur rhs; sinon, renvoie false.

Voir aussi operator!=().

[noexcept] bool operator>(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)

[noexcept] bool operator>(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)

Renvoie true si l'élément désigné par l'itérateur lhs est supérieur à l'élément désigné par l'itérateur rhs.

[noexcept] bool operator>=(const QJsonArray::iterator &lhs, const QJsonArray::iterator &rhs)

[noexcept] bool operator>=(const QJsonArray::iterator &lhs, const QJsonArray::const_iterator &rhs)

Renvoie true si l'élément désigné par l'itérateur lhs est supérieur ou égal à l'élément désigné 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.