Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QDirListing::const_iterator Class

class QDirListing::const_iterator

Cette classe a été introduite dans Qt 6.8.

Types publics

pointer
reference

Fonctions publiques

QDirListing::const_iterator::reference operator*() const
QDirListing::const_iterator &operator++()
void operator++(int)
QDirListing::const_iterator::pointer operator->() const

Description détaillée

Type d'itérateur renvoyé par QDirListing::cbegin().

  • Il s'agit d'un itérateur à passage unique (il n'est pas possible d'itérer les entrées du répertoire dans l'ordre inverse).
  • Ne peut pas être copié, seulement std::move()d.
  • La valeur de retour de post-incrément sur les objets qui modélisent std::input_iterator est partiellement formée (une copie d'un itérateur qui a été avancé depuis), les seules opérations valides sur un tel objet sont la destruction et l'affectation d'un nouvel itérateur. Par conséquent, l'opérateur post-incrément fait avancer l'itérateur et renvoie void.
  • Ne permet pas l'accès aléatoire
  • Peut être utilisé dans les boucles "ranged-for" ou avec les algorithmes C++20 std::ranges qui ne nécessitent pas d'itérateurs à accès aléatoire.
  • Le déréférencement d'un itérateur valide renvoie un const DirEntry &
  • (c)end() renvoie un QDirListing::sentinel qui signale la fin de l'itération. Le déréférencement d'un itérateur dont la comparaison est égale à end() est un comportement indéfini.

Note : Les algorithmes STL "classiques" ne supportent pas les itérateurs/sentinelles, vous devez donc utiliser les algorithmes std::ranges du C++20 pour QDirListing, ou une bibliothèque tierce qui fournit des algorithmes basés sur des intervalles en C++17.

Voir aussi QDirListing, QDirListing::sentinel, et QDirListing::DirEntry.

Documentation des types de membres

[alias] const_iterator::pointer

Un typedef pour const QDirListing::DirEntry *.

[alias] const_iterator::reference

Un typedef pour const QDirListing::DirEntry &.

Documentation des fonctions membres

QDirListing::const_iterator::reference const_iterator::operator*() const

Renvoie une adresse const QDirListing::DirEntry & de l'entrée de répertoire vers laquelle pointe cet itérateur.

QDirListing::const_iterator &const_iterator::operator++()

Opérateur de pré-incrémentation. Fait avancer l'itérateur et renvoie une référence à celui-ci.

void const_iterator::operator++(int)

Opérateur post-incrément.

QDirListing::const_iterator Modèles C++20 std::input_iterator, c'est-à-dire qu'il s'agit d'un itérateur à déplacement uniquement, à progression uniquement, à passage unique, qui n'autorise pas l'accès aléatoire.

La valeur de retour de post-incrément sur les objets qui modélisent std::input_iterator est partiellement formée (une copie d'un itérateur qui a été avancé depuis), les seules opérations valides sur un tel objet sont la destruction et l'assignation d'un nouvel itérateur. Par conséquent, l'opérateur post-incrément fait avancer l'itérateur et renvoie void.

QDirListing::const_iterator::pointer const_iterator::operator->() const

Renvoie une adresse const QDirListing::DirEntry * à l'entrée de répertoire vers laquelle pointe cet itérateur.

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