Sur cette page

QTaggedIterator Class

template <typename Iterator, typename IteratorCategory> class QTaggedIterator

QTaggedIterator est une classe de modèle qui encapsule un itérateur et met en avant les caractéristiques standard des itérateurs. En savoir plus...

En-tête : #include <QTaggedIterator>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core
Depuis : Qt 6.0

Fonctions publiques

QTaggedIterator(Iterator &&it)
bool operator!=(const QTaggedIterator<Iterator, IteratorCategory> &other) const
QTaggedIterator<Iterator, IteratorCategory> operator+(qsizetype j) const
QTaggedIterator<Iterator, IteratorCategory> &operator++()
QTaggedIterator<Iterator, IteratorCategory> operator++(int x)
QTaggedIterator<Iterator, IteratorCategory> &operator+=(qsizetype j)
qsizetype operator-(const QTaggedIterator<Iterator, IteratorCategory> &j) const
QTaggedIterator<Iterator, IteratorCategory> operator-(qsizetype j) const
QTaggedIterator<Iterator, IteratorCategory> &operator--()
QTaggedIterator<Iterator, IteratorCategory> operator--(int x)
QTaggedIterator<Iterator, IteratorCategory> &operator-=(qsizetype j)
bool operator==(const QTaggedIterator<Iterator, IteratorCategory> &other) const
QTaggedIterator<Iterator, IteratorCategory> operator+(qsizetype j, const QTaggedIterator<Iterator, IteratorCategory> &k)

Description détaillée

QTaggedIterator<Iterator, IteratorCategory> encapsule un itérateur, où Iterator est le type d’itérateur sous-jacent (tel que QIterator ou QConstIterator) et IteratorCategory est une balise de catégorie d’itérateur standard (telle que std::forward_iterator_tag ou std::random_access_iterator_tag).

Pour pouvoir utiliser un itérateur avec l'un des algorithmes standard, ses traits d'itérateur doivent être connus. Étant donné qu'un ` QMetaSequence::Iterable ` peut fonctionner avec de nombreux types de conteneurs différents, il n'est pas possible de déclarer ces traits directement dans les classes d'itérateurs elles-mêmes. Un `QTaggedIterator` permet de déclarer explicitement un trait pour une instance concrète d'un itérateur ou d'un ` QConstIterator`.

Documentation des fonctions membres

QTaggedIterator::QTaggedIterator(Iterator &&it)

Construit un QTaggedIterator à partir d'un itérateur ou d'QConstIterator it . Vérifie si la classe IteratorCategory transmise en tant qu'argument de modèle correspond aux capacités d'exécution de it; en cas de non-correspondance, la création de it est refusée.

bool QTaggedIterator::operator!=(const QTaggedIterator<Iterator, IteratorCategory> &other) const

Renvoie ` true ` si ` other ` pointe vers un élément différent de cet itérateur ; sinon, renvoie ` false`.

Voir également operator==().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator+(qsizetype j) const

Renvoie un itérateur pointant vers l'élément situé à j positions en avant par rapport à cet itérateur.

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

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator++()

L'opérateur préfixe ++ (++it) fait avancer l'itérateur vers l'élément suivant du conteneur et renvoie un itérateur pointant vers le nouvel élément courant.

L'appel de cette fonction sur QMetaSequence::Iterable::constEnd() conduit à des résultats indéfinis.

Voir également operator--().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator++(int x)

L'opérateur postfixe « ++ » (it++) fait avancer l'itérateur vers l'élément suivant du conteneur 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.

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator+=(qsizetype j)

Fait avancer l'itérateur de j éléments.

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

qsizetype QTaggedIterator::operator-(const QTaggedIterator<Iterator, IteratorCategory> &j) const

Renvoie la distance entre cet itérateur et j.

Voir également operator+(), operator-=() et QIterable::canReverseIterate().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator-(qsizetype j) const

Renvoie un itérateur pointant vers l'élément situé à j positions en arrière par rapport à cet itérateur.

Si le conteneur spécifié dans ` QVariant ` ne prend pas en charge l'itération bidirectionnelle, l'appel de cette fonction entraîne des résultats indéfinis.

Voir également operator+(), operator-=() et QIterable::canReverseIterate().

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator--()

L'opérateur préfixe -- (--it) désigne l'élément précédent comme élément courant et renvoie un itérateur vers ce nouvel élément courant.

L'appel de cette fonction sur QMetaSequence::Iterable::constBegin() conduit à des résultats indéfinis.

Si le conteneur utilisé dans l'QVariant ne prend pas en charge l'itération bidirectionnelle, l'appel de cette fonction conduit à des résultats indéfinis.

Voir également operator++() et QIterable::canReverseIterate().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator--(int x)

L'opérateur d'-- postfixe (it--) désigne l'élément précédent comme élément courant et renvoie un itérateur vers l'élément qui était auparavant l'élément courant.

Si le conteneur utilisé dans l'QVariant ne prend pas en charge l'itération bidirectionnelle, l'appel de cette fonction conduit à des résultats indéfinis.

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

Voir également ` QIterable::canReverseIterate()`.

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator-=(qsizetype j)

Fait reculer l'itérateur de j éléments.

Si le conteneur spécifié dans ` QVariant ` ne prend pas en charge l’itération bidirectionnelle, l’appel de cette fonction entraîne des résultats indéfinis.

Voir également operator+=(), operator-() et QIterable::canReverseIterate().

bool QTaggedIterator::operator==(const QTaggedIterator<Iterator, IteratorCategory> &other) const

Renvoie ` true ` si ` other ` pointe vers le même élément que cet itérateur ; sinon, renvoie ` false`.

Voir également operator!=().

Éléments non membres associés

QTaggedIterator<Iterator, IteratorCategory> operator+(qsizetype j, const QTaggedIterator<Iterator, IteratorCategory> &k)

Renvoie un itérateur pointant vers l'élément situé à ` j ` positions en avant par rapport à l'itérateur ` k`.

© 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.