const_iterator Class
class QDirListing::const_iteratorDiese Klasse wurde in Qt 6.8 eingeführt.
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- const_iterator ist Teil von Input/Output und Networking.
Ö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 gibtvoid
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.