QJsonObject::const_iterator Class
class QJsonObject::const_iteratorLa classe ` QJsonObject::const_iterator ` fournit un itérateur `const` de type STL pour ` QJsonObject`. En savoir plus...
- Liste de tous les membres, y compris les membres hérités
- const_iterator fait partie de la prise en charge JSON dans Qt.
Comparaisons de QJsonObject::const_iterator
| Catégorie | Types comparables |
|---|---|
| strong | QJsonObject::const_iterator |
| strong | QJsonObject::iterator. |
Types publics
Fonctions publiques
| const_iterator() | |
| const_iterator(const QJsonObject::iterator &other) | |
| const_iterator(const QJsonObject::const_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 |
Éléments non membres associé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 vous permet de parcourir un objet ` QJsonObject`. Si vous souhaitez modifier l’ QJsonObject au fur et à mesure de son parcours, vous devez utiliser ` QJsonObject::iterator ` à la place. Il est généralement recommandé d’utiliser ` QJsonObject::const_iterator ` sur un objet ` QJsonObject ` non-const également, sauf si vous avez besoin de modifier l’ QJsonObject 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 ` 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.
Il est possible d'utiliser plusieurs itérateurs sur un même objet. Les itérateurs existants deviendront toutefois « pendants » si l'objet est modifié.
Voir également QJsonObject::iterator, la prise en charge de JSON dans Qt, ainsi que la sauvegarde et le chargement d’une partie.
Documentation sur les types de membres
const_iterator::iterator_category
Synonyme de std::random_access_iterator_tag indiquant que cet itérateur est un itérateur à accès aléatoire.
Remarque : dans les versions de Qt antérieures à la version 5.6, cette valeur avait été définie par erreur sur std::bidirectional_iterator_tag.
Documentation des fonctions membres
const_iterator::const_iterator()
Crée un itérateur non initialisé.
Les fonctions telles que ` key()`, ` value()` et l'opérateur `++()` ne doivent pas être appelées sur un itérateur non initialisé. Utilisez l'opérateur `=()` pour lui attribuer une valeur avant de l'utiliser.
Voir également QJsonObject::constBegin() et QJsonObject::constEnd().
const_iterator::const_iterator(const QJsonObject::iterator &other)
Crée une copie de other.
[constexpr noexcept default] const_iterator::const_iterator(const QJsonObject::const_iterator &other)
Crée une instance de ` const_iterator` par copie.
QString const_iterator::key() const
Renvoie la clé de l'élément actuel.
Voir également value() et keyView().
[since 6.10] QAnyStringView const_iterator::keyView() const
Renvoie la clé de l'élément courant sous la forme d'un ` QAnyStringView`. Cette fonction n'effectue aucune allocation de mémoire.
Étant donné que ` QJsonObject ` stocke les clés au format US-ASCII, UTF-8 ou UTF-16, l'QAnyStringView e renvoyé peut être dans n'importe lequel de ces encodages.
Cette fonction a été introduite dans Qt 6.10.
Voir également value() et key().
QJsonValueConstRef const_iterator::value() const
Renvoie la valeur de l'élément courant.
Voir également key(), keyView() et operator*().
const QJsonValueConstRef const_iterator::operator*() const
Renvoie la valeur de l'élément actuel.
Equivalent à value().
Voir également key() et keyView().
QJsonObject::const_iterator const_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 négatif, l'itérateur se déplace vers l'arrière.
Cette opération peut être lente lorsque les valeurs de ` j ` sont élevées.
Voir aussi operator-().
QJsonObject::const_iterator &const_iterator::operator++()
L'opérateur préfixe « ++ », ++i, fait avancer l'itérateur vers l'élément suivant de l'objet et renvoie un itérateur pointant vers le nouvel élément actuel.
L'appel de cette fonction sur ` QJsonObject::end()` conduit à des résultats indéfinis.
Voir également operator--().
QJsonObject::const_iterator const_iterator::operator++(int)
L'opérateur d'++ postfixe, i++, fait avancer l'itérateur vers l'élément suivant de l'objet et renvoie un itérateur pointant vers l'élément qui était précédemment sélectionné.
Il s'agit d'une fonction surchargée.
QJsonObject::const_iterator &const_iterator::operator+=(qsizetype j)
Fait avancer l'itérateur de j éléments. Si j est négatif, l'itérateur recule.
Cette opération peut être lente lorsque la valeur de ` j ` est élevée.
Voir également operator-=() et operator+().
qsizetype const_iterator::operator-(QJsonObject::const_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.
QJsonObject::const_iterator const_iterator::operator-(qsizetype j) const
Renvoie un itérateur 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.
Cette opération peut être lente lorsque la valeur de ` j ` est élevée.
Voir également operator+().
QJsonObject::const_iterator &const_iterator::operator--()
L'opérateur préfixe « -- », --i, définit l'élément précédent comme élément courant et renvoie un itérateur pointant vers ce nouvel élément courant.
L'appel de cette fonction sur QJsonObject::begin() conduit à des résultats indéfinis.
Voir également operator++().
QJsonObject::const_iterator const_iterator::operator--(int)
L'opérateur postfixe « -- », i--, désigne l'élément précédent comme élément courant et renvoie un itérateur pointant vers l'élément qui était auparavant l'élément courant.
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 lorsque la valeur de j est élevée.
Voir également operator+=() et operator-().
const QJsonValueConstRef *const_iterator::operator->() const
Renvoie un pointeur vers l'élément actuel.
QJsonValueConstRef const_iterator::operator[](qsizetype j) const
Renvoie 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 QJsonObject de se comporter comme des pointeurs C++.
Voir également operator+().
Éléments non membres associé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 celui indiqué par l'itérateur ` rhs ` ; sinon, renvoie ` false`.
Voir également operator==().
[noexcept] bool operator<(const QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs)
Renvoie « true » si l'élément pointé par l'itérateur lhs est inférieur à l'élément pointé par l'itérateur rhs.
[noexcept] bool operator<=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_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 QJsonObject::const_iterator &lhs, const QJsonObject::const_iterator &rhs)
Renvoie ` true ` si ` lhs ` pointe vers 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 pointé par l'itérateur lhs est supérieur à l'élément pointé par l'itérateur rhs.
[noexcept] bool operator>=(const QJsonObject::const_iterator &lhs, const QJsonObject::const_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.
