QDirListing Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein `QDirListing`, das ` path` durchlaufen kann.

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

Standardmäßig lautet „ flags “ „ IteratorFlag::Default “.

Siehe auch „ IteratorFlags “.

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

Erstellt ein `QDirListing`, das ` path` durchlaufen kann.

Sie können über flags Optionen übergeben, um zu steuern, wie das Verzeichnis durchlaufen werden soll. Standardmäßig lautet flags „ IteratorFlag::Default “.

Die aufgelisteten Einträge werden gemäß den Dateimuster-Regeln in ` nameFilters` gefiltert, die mithilfe von ` QRegularExpression::fromWildcard ` in einen regulären Ausdruck umgewandelt werden (weitere Details finden Sie unter ` QDir::setNameFilters()`).

Beispielsweise könnte der folgende Iterator verwendet werden, um Audio-Dateien zu durchlaufen:

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

Manchmal lässt sich die Filterung nach Namen effizienter durchführen, indem man die Einträge mit einer `range-for`-Schleife durchläuft und dabei Zeichenfolgenvergleiche nutzt. Zum Beispiel:

    using F = QDirListing::IteratorFlag;
    const auto flags = F::FilesOnly | F::Recursive | F::ResolveSymlinks;
    for (const auto &dirEntry : QDirListing(u"/usr"_s, flags)) {
        // Faster than using name filters, filter ".txt" and ".html" files
        // using QString API
        const QString fileName = dirEntry.fileName();
        if (fileName.endsWith(".txt"_L1) || fileName.endsWith(".html"_L1)) {
            // ...
        }
    }
}

Siehe auch IteratorFlags und QDir::setNameFilters().

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

Move-Konstruktor. Verschiebt „ other “ in dieses „QDirListing“.

[noexcept] QDirListing::~QDirListing()

Zerstört den „ QDirListing “.

(c) `begin()` gibt ein ` QDirListing::const_iterator ` zurück, mit dem die Verzeichniseinträge durchlaufen werden können.

• Es handelt sich um einen Iterator, der nur vorwärts und in einem Durchgang arbeitet (Verzeichniseinträge können nicht in umgekehrter Reihenfolge durchlaufen werden)
• Kann nicht kopiert werden, nur std::move()d.
• Der Rückgabewert der Postinkrementierung bei Objekten, die std::input_iterator implementieren, ist unvollständig (eine Kopie eines Iterators, der inzwischen weitergeschritten ist); die einzigen gültigen Operationen für ein solches Objekt sind die Zerstörung und die Zuweisung eines neuen Iterators. Daher schreitet der Postinkrement-Operator den Iterator voran und gibt void zurück.
• Erlaubt keinen Direktzugriff
• Kann in `for-range`-Schleifen verwendet werden oder mit C++20-`std::ranges`-Algorithmen, die keine Iteratoren mit wahlfreiem Zugriff erfordern
• Die Dereferenzierung eines gültigen Iterators gibt einen const DirEntry &
• (c) `end()` gibt einen ` QDirListing::sentinel ` zurück, der das Ende der Iteration signalisiert. Die Dereferenzierung eines Iterators, der mit ` end()` gleich ist, führt zu undefiniertem Verhalten

(Einige der oben genannten Einschränkungen ergeben sich aus der Implementierung der zugrunde liegenden Systembibliotheksfunktionen).

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 können Sie alle Dateien, die nach Namen gefiltert wurden, rekursiv finden und lesen:

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

QDirListing::IteratorFlags QDirListing::iteratorFlags() const

Gibt die Menge der „ IteratorFlags “ zurück, die zur Erstellung dieses „ QDirListing “ verwendet wurden.

QString QDirListing::iteratorPath() const

Gibt den Verzeichnispfad zurück, der zum Erstellen dieses QDirListing verwendet wurde.

QStringList QDirListing::nameFilters() const

Gibt die Liste der Dateinamen-Glob-Filter zurück, die zum Erstellen dieses ` QDirListing` verwendet wurden.

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

Durch die Verschiebung wird other diesem QDirListing zugewiesen.