QDirListing Class

Documentation des fonctions membres

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

Construit une QDirListing qui peut itérer sur path.

Vous pouvez passer des options via flags pour contrôler la façon dont le répertoire doit être itéré.

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

Voir aussi IteratorFlags.

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

Construit une QDirListing qui peut itérer sur path.

Vous pouvez passer des options via flags pour contrôler la façon dont le répertoire doit être itéré. Par défaut, flags est IteratorFlag::Default.

Les entrées de la liste seront filtrées en fonction des motifs globaux de fichier dans nameFilters, qui sont convertis en une expression régulière à l'aide de QRegularExpression::fromWildcard (voir QDir::setNameFilters() pour plus de détails).

Par exemple, l'itérateur suivant peut ê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 de manière plus efficace en itérant sur les entrées à l'aide d'une boucle range-for, en utilisant la comparaison de chaînes. Par exemple, l'itérateur suivant pourrait être utilisé pour parcourir les fichiers audio

    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 other dans cette QDirListing.

[noexcept] QDirListing::~QDirListing()

Détruit le site QDirListing.

(c)begin() renvoie un QDirListing::const_iterator qui peut être utilisé pour parcourir les entrées du répertoire.

• Il s'agit d'un itérateur à passage unique (il n'est pas possible d'itérer les entrées du répertoire dans l'ordre inverse).
• Ne peut pas être copié, seulement std::move()d.
• La valeur de retour de post-incrément sur les objets qui modélisent std::input_iterator est partiellement formée (une copie d'un itérateur qui a été avancé depuis), les seules opérations valides sur un tel objet sont la destruction et l'assignation d'un nouvel itérateur. Par conséquent, l'opérateur post-incrément fait avancer l'itérateur et renvoie void.
• Ne permet pas l'accès aléatoire
• Peut être utilisé dans les boucles "ranged-for" ou avec les algorithmes C++20 std::ranges qui ne nécessitent pas d'itérateurs à accès aléatoire.
• Le déréférencement d'un itérateur valide renvoie une valeur de const DirEntry &
• (c)end() renvoie un QDirListing::sentinel qui signale la fin de l'itération. Le déréférencement d'un itérateur dont la comparaison est égale à end() est 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 trouver et lire tous les fichiers filtrés par nom, de manière récursive :

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

Voir aussi QDirListing::DirEntry.

QDirListing::IteratorFlags QDirListing::iteratorFlags() const

Renvoie l'ensemble de IteratorFlags utilisé pour construire ce QDirListing.

QString QDirListing::iteratorPath() const

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

QStringList QDirListing::nameFilters() const

Retourne la liste des filtres globaux de noms de fichiers utilisés pour construire ce QDirListing.

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

Move-assigns other to this QDirListing.