QDirListing Class

Dokumentation der Mitgliedsfunktionen

(c)begin() gibt eine QDirListing::const_iterator zurück, die zur Iteration über Verzeichniseinträge verwendet werden kann.

• Es handelt sich um einen Iterator, der nur vorwärts läuft (Sie können die Verzeichniseinträge nicht in umgekehrter Reihenfolge durchlaufen).
• 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

(Einige der oben genannten Einschränkungen werden durch die Implementierung der zugrunde liegenden Systembibliotheksfunktionen diktiert).

Ein Beispiel:

using ItFlag = QDirListing::IteratorFlag;for(const auto &dirEntry: QDirListing(u"/etc"_s, ItFlag::Recursive)) {    qDebug() << dirEntry.filePath();
   // /etc/. // /etc/... // /etc/X11 // /etc/X11/fs // ...}

So finden und lesen Sie alle nach Namen gefilterten Dateien, rekursiv:

using F = QDirListing::IteratorFlag;QDirListing dirList(u"/sys"_s, QStringList{u"scaling_cur_freq"_s}, F::FilesOnly | F::Recursive);for(const auto &dirEntry: dirList) { QFile f(dirEntry.filePath()); if (f.open(QIODevice::ReadOnly))        qDebug() << f.fileName() << f.readAll().trimmed().toDouble() / 1000 << "MHz";
}

Siehe auch QDirListing::DirEntry.

[explicit] QDirListing::QDirListing(const QString &path, QDirListing::IteratorFlags flags = IteratorFlag::Default)

Konstruiert ein QDirListing, das über path iterieren kann.

Sie können Optionen über flags übergeben, um zu steuern, wie das Verzeichnis iteriert werden soll.

Standardmäßig ist flags IteratorFlag::Default .

Siehe auch IteratorFlags.

[explicit] QDirListing::QDirListing(const QString &path, const QStringList &nameFilters, QDirListing::IteratorFlags flags = IteratorFlag::Default)

Konstruiert ein QDirListing, das über path iterieren kann.

Sie können Optionen über flags übergeben, um zu steuern, wie das Verzeichnis iteriert werden soll. Standardmäßig ist flags gleich IteratorFlag::Default.

Die aufgelisteten Einträge werden nach den Dateiglob-Mustern in nameFilters gefiltert (siehe QDir::setNameFilters() für weitere Details).

Zum Beispiel könnte der folgende Iterator verwendet werden, um über Audiodateien zu iterieren:

QDirListing audioFileIt(u"/home/johndoe/"_s, QStringList{u"*.mp3"_s, u"*.wav"_s},
                        QDirListing::IteratorFlag::FilesOnly);

Siehe auch IteratorFlags und QDir::setNameFilters().

[noexcept] QDirListing::QDirListing(QDirListing &&other)

Verschieben-Konstruktor. Verschiebt other in dieses QDirListing.

[noexcept] QDirListing::~QDirListing()

Zerstört die QDirListing.

QDirListing::IteratorFlags QDirListing::iteratorFlags() const

Gibt die Menge von IteratorFlags zurück, die für die Erstellung dieser QDirListing verwendet wurde.

QString QDirListing::iteratorPath() const

Gibt den Verzeichnispfad zurück, der für die Erstellung dieses QDirListing verwendet wurde.

QStringList QDirListing::nameFilters() const

Gibt die Liste der Dateinamen-Glob-Filter zurück, die für die Erstellung dieser QDirListing verwendet wurden.

[noexcept] QDirListing &QDirListing::operator=(QDirListing &&other)

Verschieben - weist other diesem QDirListing zu.