QJsonObject::iterator Class

Documentation des fonctions membres

iterator::iterator()

Construit un itérateur non initialisé.

Les fonctions telles que key(), value() 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 QJsonObject::begin() et QJsonObject::end().

QString 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 par l'intermédiaire d'un itérateur, mais il est possible de le faire en appelant QJsonObject::erase() suivi de QJsonObject::insert().

Voir aussi value() et keyView().

[since 6.10] QAnyStringView iterator::keyView() const

Renvoie la clé de l'élément en cours sous la forme d'un fichier QAnyStringView. Cette fonction n'alloue pas de mémoire.

Comme QJsonObject stocke les clés en US-ASCII, UTF-8 ou UTF-16, le QAnyStringView renvoyé peut être dans n'importe lequel de ces encodages.

Il n'y a pas de moyen direct de changer la clé d'un élément à travers un itérateur, bien que cela puisse être fait en appelant QJsonObject::erase() suivi de QJsonObject::insert().

Cette fonction a été introduite dans Qt 6.10.

Voir aussi key() et value().

QJsonValueRef iterator::value() const

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

Vous pouvez modifier la valeur d'un élément en utilisant value() 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 à QJsonValue. Si vous l'affectez, l'affectation s'appliquera à l'élément de QJsonArray ou QJsonObject à partir duquel vous avez obtenu la référence.

Voir également key(), keyView() et operator*().

QJsonValueRef iterator::operator*() const

Renvoie une référence modifiable à la valeur de l'élément en cours.

Identique à value().

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 à l'élément dans QJsonArray ou QJsonObject à partir duquel vous avez obtenu la référence.

Voir également key() et keyView().

QJsonObject::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-().

QJsonObject::iterator &iterator::operator++()

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

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

Voir aussi operator--().

QJsonObject::iterator iterator::operator++(int)

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

QJsonObject::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-(QJsonObject::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.

QJsonObject::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+().

QJsonObject::iterator &iterator::operator--()

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

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

Voir aussi operator++().

QJsonObject::iterator iterator::operator--(int)

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

QJsonObject::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-().

QJsonValueRef *iterator::operator->()

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

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

Renvoie un pointeur sur une référence constante à l'élément actuel.

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 QJsonObject 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+().