const_iterator Class

class QDirListing::const_iterator

Diese Klasse wurde in Qt 6.8 eingeführt.

Öffentliche Typen

Öffentliche Funktionen

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

Detaillierte Beschreibung

Der Iterator-Typ, der von QDirListing::cbegin() zurückgegeben wird.

  • Es handelt sich um einen Iterator, der nur vorwärts läuft (Sie können Verzeichniseinträge nicht in umgekehrter Reihenfolge iterieren).
  • Kann nicht kopiert werden, nur std::move()d.
  • Der Rückgabewert von post-increment auf Objekten, die std::input_iterator modellieren, ist teilweise geformt (eine Kopie eines Iterators, der seither weitergeschaltet wurde), die einzigen gültigen Operationen auf einem solchen Objekt sind Zerstörung und Zuweisung eines neuen Iterators. Daher schiebt der Post-Increment-Operator den Iterator vor und gibt void zurück.
  • Erlaubt keinen zufälligen Zugriff
  • Kann in ranged-for-Schleifen verwendet werden; oder mit C++20 std::ranges-Algorithmen, die keine Iteratoren mit wahlfreiem Zugriff erfordern
  • Die Dereferenzierung eines gültigen Iterators gibt ein const DirEntry &
  • (c)end() gibt eine QDirListing::sentinel zurück, die das Ende der Iteration signalisiert. Das Dereferenzieren eines Iterators, der gleich end() vergleicht, ist undefiniertes Verhalten.

Hinweis: Die "klassischen" STL-Algorithmen unterstützen Iterator/Sentinel nicht, daher müssen Sie C++20 std::ranges-Algorithmen für QDirListing verwenden, oder eine Bibliothek eines Drittanbieters, die bereichsbasierte Algorithmen in C++17 bereitstellt.

Siehe auch QDirListing, QDirListing::sentinel, und QDirListing::DirEntry.

Dokumentation der Mitgliedstypen

[alias] const_iterator::pointer

Ein Typedef für const QDirListing::DirEntry *.

[alias] const_iterator::reference

Ein Typedef für const QDirListing::DirEntry &.

Dokumentation der Mitgliedsfunktionen

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

Gibt eine const QDirListing::DirEntry & des Verzeichniseintrags zurück, auf den dieser Iterator zeigt.

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

Vorinkrement-Operator. Erweitert den Iterator und gibt einen Verweis auf ihn zurück.

void const_iterator::operator++(int)

Post-Inkrement-Operator.

QDirListing::const_iterator modelliert C++20 std::input_iterator, d.h. es handelt sich um einen "move-only", "forward-only", "single-pass" Iterator, der keinen zufälligen Zugriff erlaubt.

Der Rückgabewert von post-increment auf Objekten, die std::input_iterator modellieren, ist teilweise geformt (eine Kopie eines Iterators, der seither weitergeschaltet wurde), die einzigen gültigen Operationen auf einem solchen Objekt sind Zerstörung und Zuweisung eines neuen Iterators. Daher schiebt der Post-Increment-Operator den Iterator vor und gibt void zurück.

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

Gibt eine const QDirListing::DirEntry * zu dem Verzeichniseintrag zurück, auf den dieser Iterator zeigt.

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