QJsonObject::const_iterator Class
class QJsonObject::const_iteratorLa classe QJsonObject::const_iterator fournit un itérateur constant de style STL pour QJsonObject. Plus d'informations...
- Liste de tous les membres, y compris les membres hérités
- const_iterator fait partie du support JSON dans Qt.
Cette classe est fortement comparable.
Cette classe est fortement comparable à QJsonObject::iterator.
Types publics
Fonctions publiques
| const_iterator() | |
| const_iterator(const QJsonObject::iterator &other) | |
| QString | key() const |
(since 6.10) QAnyStringView | keyView() const |
| QJsonValueConstRef | value() const |
| const QJsonValueConstRef | operator*() const |
| QJsonObject::const_iterator | operator+(qsizetype j) const |
| QJsonObject::const_iterator & | operator++() |
| QJsonObject::const_iterator | operator++(int) |
| QJsonObject::const_iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QJsonObject::const_iterator other) const |
| QJsonObject::const_iterator | operator-(qsizetype j) const |
| QJsonObject::const_iterator & | operator--() |
| QJsonObject::const_iterator | operator--(int) |
| QJsonObject::const_iterator & | operator-=(qsizetype j) |
| const QJsonValueConstRef * | operator->() const |
| QJsonValueConstRef | operator[](qsizetype j) const |
Non-membres apparentés
| bool | operator!=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator<(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator<=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator==(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator>(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
| bool | operator>=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs) |
Description détaillée
QJsonObject::const_iterator permet d'itérer sur un QJsonObject. Si vous souhaitez modifier le QJsonObject au cours de l'itération, vous devez utiliser QJsonObject::iterator à la place. Il est généralement conseillé d'utiliser QJsonObject::const_iterator sur un QJsonObject non-const également, à moins que vous n'ayez besoin de modifier le QJsonObject 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 QJsonObject::const_iterator crée un itérateur non initialisé. Vous devez l'initialiser à l'aide d'une fonction QJsonObject telle que QJsonObject::constBegin(), QJsonObject::constEnd() ou QJsonObject::find() avant de pouvoir commencer l'itération.
Plusieurs itérateurs peuvent être utilisés sur le même objet. Les itérateurs existants seront cependant suspendus si l'objet est modifié.
Voir aussi QJsonObject::iterator, JSON Support in Qt, et Saving and Loading a Game.
Documentation sur les types de membres
const_iterator::iterator_category
Un synonyme de std::random_access_iterator_tag indiquant que cet itérateur est un itérateur à accès aléatoire.
Note : Dans les versions de Qt antérieures à la 5.6, ce paramètre était défini par erreur à std::bidirectional_iterator_tag.
Documentation des fonctions membres
const_iterator::const_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 également QJsonObject::constBegin() et QJsonObject::constEnd().
const_iterator::const_iterator(const QJsonObject::iterator &other)
Construit une copie de other.
QString const_iterator::key() const
Renvoie la clé de l'élément en cours.
Voir aussi value() et keyView().
[since 6.10] QAnyStringView const_iterator::keyView() const
Renvoie la clé de l'élément en cours sous la forme d'un QAnyStringView. Cette fonction n'alloue pas de ressources.
Comme QJsonObject stocke les clés en US-ASCII, UTF-8 ou UTF-16, le QAnyStringView retourné peut être dans n'importe lequel de ces encodages.
Cette fonction a été introduite dans Qt 6.10.
QJsonValueConstRef const_iterator::value() const
Renvoie la valeur de l'élément en cours.
Voir aussi key(), keyView() et operator*().
const QJsonValueConstRef const_iterator::operator*() const
Renvoie la valeur de l'élément courant.
Identique à value().
Voir aussi key() et keyView().
QJsonObject::const_iterator const_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.
Cette opération peut être lente pour les grandes valeurs de j.
Voir également operator-().
QJsonObject::const_iterator &const_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::const_iterator const_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.
Il s'agit d'une fonction surchargée.
QJsonObject::const_iterator &const_iterator::operator+=(qsizetype j)
Avance l'itérateur de j éléments. Si j est négatif, l'itérateur recule.
Cette opération peut être lente pour les grandes valeurs de j.
Voir également operator-=() et operator+().
qsizetype const_iterator::operator-(QJsonObject::const_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::const_iterator const_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.
Cette opération peut être lente pour les grandes valeurs de j.
Voir également operator+().
QJsonObject::const_iterator &const_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::const_iterator const_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.
Il s'agit d'une fonction surchargée.
QJsonObject::const_iterator &const_iterator::operator-=(qsizetype j)
Fait reculer l'itérateur de j éléments. Si j est négatif, l'itérateur avance.
Cette opération peut être lente pour les grandes valeurs de j.
Voir aussi operator+=() et operator-().
const QJsonValueConstRef *const_iterator::operator->() const
Renvoie un pointeur sur l'élément en cours.
QJsonValueConstRef const_iterator::operator[](qsizetype j) const
Renvoie 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++.
Voir également operator+().
Non-membres apparentés
[noexcept] bool operator!=(const QJsonObject::const_iterator &lhs, const QJsonObject::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 QJsonObject::const_iterator &lhs, const QJsonObject::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 QJsonObject::const_iterator &lhs, const QJsonObject::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 QJsonObject::const_iterator &lhs, const QJsonObject::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 QJsonObject::const_iterator &lhs, const QJsonObject::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 QJsonObject::const_iterator &lhs, const QJsonObject::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.
