QDirListing Class

Documentation des fonctions membres

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

Crée un objet `QDirListing` permettant de parcourir ` path`.

Vous pouvez passer des options via ` flags ` pour contrôler la manière dont le répertoire doit être parcouru.

Par défaut, ` flags ` est ` IteratorFlag::Default`.

Voir également IteratorFlags.

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

Crée un objet `QDirListing` permettant de parcourir ` path`.

Vous pouvez passer des options via flags pour contrôler la manière dont le répertoire doit être parcouru. Par défaut, flags est défini sur IteratorFlag::Default.

Les entrées répertoriées seront filtrées selon les modèles de recherche de fichiers définis dans ` nameFilters`, qui sont convertis en expression régulière à l’aide de ` QRegularExpression::fromWildcard ` (voir ` QDir::setNameFilters()` pour plus de détails).

Par exemple, l’itérateur suivant pourrait être utilisé pour parcourir les fichiers audio :

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

Il est parfois possible de filtrer par nom plus efficacement en parcourant les entrées à l’aide d’une boucle « range-for », en utilisant la comparaison de chaînes de caractères. Par exemple :

    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)) {
            // ...
        }
    }
}

Voir également IteratorFlags et QDir::setNameFilters().

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

Constructeur de déplacement. Déplace l'other vers ce QDirListing.

[noexcept] QDirListing::~QDirListing()

Supprime l'QDirListing.

(c) La fonction `begin()` renvoie un objet ` QDirListing::const_iterator ` qui permet de parcourir les entrées du répertoire.

• Il s'agit d'un itérateur à passage unique et à sens unique (vous ne pouvez pas parcourir les entrées du répertoire dans l'ordre inverse)
• Il ne peut pas être copié ; seul std::move()d peut l'être.
• La valeur de retour de l’opérateur de post-incrément sur les objets implémentant std::input_iterator est partiellement formée (une copie d’un itérateur qui a depuis été avancé) ; 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 de post-incrément fait avancer l’itérateur et renvoie void.
• Ne permet pas l’accès aléatoire
• Peut être utilisé dans des boucles `for` avec plage ; ou avec les algorithmes `std::ranges` de C++20 qui ne nécessitent pas d'itérateurs à accès aléatoire
• La déréférence d’un itérateur valide renvoie un const DirEntry &
• (c) La fonction `end()` renvoie une valeur ` QDirListing::sentinel ` qui signale la fin de l’itération. La déréférence d’un itérateur dont la valeur est égale à celle renvoyée par ` end()` entraîne un comportement indéfini

(Certaines des restrictions ci-dessus sont dictées par l’implémentation des fonctions de la bibliothèque système sous-jacente).

Par exemple :

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

Voici comment rechercher et lire tous les fichiers filtrés par nom, de manière récursive :

en utilisant 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";
}

Voir également QDirListing::DirEntry.

QDirListing::IteratorFlags QDirListing::iteratorFlags() const

Renvoie l'ensemble des « IteratorFlags » utilisés pour construire cet « QDirListing ».

QString QDirListing::iteratorPath() const

Renvoie le chemin d'accès au répertoire utilisé pour créer cette QDirListing.

QStringList QDirListing::nameFilters() const

Renvoie la liste des filtres de noms de fichiers globaux utilisés pour construire cette expression « QDirListing ».

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

L'opération « move-assign » attribue other à QDirListing.