Sur cette page

QCborMap::Iterator Class

class QCborMap::Iterator

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

Cette classe est fortement comparable.

Cette classe est fortement comparable à ConstIterator.

Types publics

Fonctions publiques

Iterator()
Iterator(const QCborMap::Iterator &other)
QCborValue key() const
QCborValueRef value() const
QCborMap::Iterator::value_type operator*() const
QCborMap::Iterator operator+(qsizetype j) const
QCborMap::Iterator &operator++()
QCborMap::Iterator operator++(int)
QCborMap::Iterator &operator+=(qsizetype j)
qsizetype operator-(QCborMap::Iterator j) const
QCborMap::Iterator operator-(qsizetype j) const
QCborMap::Iterator &operator--()
QCborMap::Iterator operator--(int)
QCborMap::Iterator &operator-=(qsizetype j)
const QCborValueConstRef *operator->() const
QCborMap::Iterator &operator=(const QCborMap::Iterator &other)
bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator<(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator<(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator==(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator>(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator>(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)
bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

Description détaillée

QCborMap::Iterator permet d'itérer sur un site QCborMap et de modifier la valeur (mais pas la clé) stockée sous une clé particulière. Si vous souhaitez itérer sur un const QCborMap, vous devez utiliser QCborMap::ConstIterator. Il est généralement conseillé d'utiliser QCborMap::ConstIterator sur un QCborMap non constant, à moins que vous n'ayez besoin de modifier le QCborMap 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.

Vous devez initialiser l'itérateur à l'aide d'une fonction QCborMap telle que QCborMap::begin(), QCborMap::end() ou QCborMap::find() avant de pouvoir commencer l'itération.

Plusieurs itérateurs peuvent être utilisés sur le même objet. Les itérateurs existants deviendront cependant suspendus lorsque l'objet sera modifié.

Voir également QCborMap::ConstIterator.

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

[constexpr noexcept] 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 QCborMap::begin() et QCborMap::end().

[constexpr noexcept] Iterator::Iterator(const QCborMap::Iterator &other)

Construit un itérateur comme une copie de other.

QCborValue 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 QCborMap::erase() suivi de QCborMap::insert().

Voir aussi value().

QCborValueRef Iterator::value() const

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

Vous pouvez modifier la valeur d'une clé en utilisant value() du côté gauche d'une affectation.

La valeur de retour est de type QCborValueRef, une classe d'aide pour QCborArray et QCborMap. Lorsque vous obtenez un objet de type QCborValueRef, vous pouvez l'utiliser comme s'il s'agissait d'une référence à un QCborValue. Si vous l'assignez, l'assignation s'appliquera à l'élément du QCborArray ou du QCborMap à partir duquel vous avez obtenu la référence.

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

QCborMap::Iterator::value_type Iterator::operator*() const

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

Le second élément de la paire est de type QCborValueRef, une classe d'aide pour QCborArray et QCborMap. Lorsque vous obtenez un objet de type QCborValueRef, vous pouvez l'utiliser comme s'il s'agissait d'une référence à un QCborValue. Si vous l'affectez, l'affectation s'appliquera à l'élément du QCborArray ou du QCborMap à partir duquel vous avez obtenu la référence.

Voir également key() et value().

QCborMap::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 également operator-().

QCborMap::Iterator &Iterator::operator++()

L'opérateur préfixe ++, ++i, fait passer l'itérateur à l'élément suivant de la carte et renvoie cet itérateur.

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

Voir aussi operator--().

QCborMap::Iterator Iterator::operator++(int)

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

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

QCborMap::Iterator &Iterator::operator+=(qsizetype j)

Avance l'itérateur de j éléments. Si j est négatif, l'itérateur recule. Renvoie une référence à cet itérateur.

Voir également operator-=() et operator+().

qsizetype Iterator::operator-(QCborMap::Iterator j) const

Renvoie la position de l'élément à l'itérateur j par rapport à l'élément à cet itérateur. Si l'élément à j est en avance sur ce temps, la valeur renvoyée est négative.

Voir aussi operator+().

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

QCborMap::Iterator &Iterator::operator--()

L'opérateur préfixe --, --i, rend l'élément précédent courant et renvoie cet itérateur.

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

Voir aussi operator++().

QCborMap::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.

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

QCborMap::Iterator &Iterator::operator-=(qsizetype j)

Fait reculer l'itérateur de j éléments. Si j est négatif, l'itérateur avance. Renvoie une référence à cet itérateur.

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

const QCborValueConstRef *Iterator::operator->() const

Renvoie un pointeur sur une référence modifiable de la valeur de la paire courante.

QCborMap::Iterator &Iterator::operator=(const QCborMap::Iterator &other)

Fait de cet itérateur une copie de other et renvoie une référence à cet itérateur.

Non-membres apparentés

[noexcept] bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator!=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Renvoie true si lhs pointe vers une entrée de la carte différente de celle de l'itérateur rhs; sinon, renvoie false.

Voir aussi operator==().

[noexcept] bool operator<(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator<(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Renvoie true si l'entrée de la carte indiquée par l'itérateur lhs précède l'entrée indiquée par l'itérateur rhs.

[noexcept] bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator<=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Renvoie true si l'entrée de la carte pointée par l'itérateur lhs se trouve avant ou est la même entrée que celle pointée par l'itérateur rhs.

[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator==(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Renvoie true si lhs pointe sur la même entrée de la carte que l'itérateur rhs; sinon, renvoie false.

Voir aussi operator!=().

[noexcept] bool operator>(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator>(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Renvoie true si l'entrée de la carte indiquée par l'itérateur lhs se trouve après l'entrée indiquée par l'itérateur rhs.

[noexcept] bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::Iterator &rhs)

[noexcept] bool operator>=(const QCborMap::Iterator &lhs, const QCborMap::ConstIterator &rhs)

Renvoie true si l'entrée de la carte pointée par l'itérateur lhs se trouve après ou est la même entrée que celle pointée 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.