En esta página

Portar QDirIterator a QDirListing

En Qt 6.8 se añadió QDirListing como sustituto más eficiente de QDirIterator (este último sigue estando disponible por el momento). Esta página destaca algunos puntos que hay que tener en cuenta al portar QDirIterator a QDirListing.

Con QDirIterator se pueden controlar las entradas que aparecen en la lista mediante indicadores de dos enumeradores independientes, QDirIterator::IteratorFlags y QDir::Filters, mientras que QDirListing cuenta con un único conjunto de indicadores para realizar esta tarea.

Portar QDirIterator::IteratorFlags a QDirListing::IteratorFlags es sencillo:

Portar QDir::Filters a QDirListing::IteratorFlags puede resultar más complejo, dependiendo de la combinación mediante OR bit a bit de QDir::Filters que utilices.

  • Por defecto, QDirListing muestra directorios, archivos normales, enlaces simbólicos y entradas especiales (otras) del sistema de archivos; puedes excluir entradas en función de su tipo utilizando los distintos indicadores QDirListing::IteratorFlag::Exclude*.
  • QDirEl filtro predeterminado es ` QDir::AllEntries`, que equivale a:
    using F = QDirListing::IteratorFlag;
    QDirListing::IteratorFlags(F::ExcludeOther|F::ResolveSymlinks|F::IncludeDotAndDotDot);
  • Por defecto, ` QDirListing ` muestra las unidades (de Windows), por lo que no existe un equivalente para ` QDir::Drives`.
  • QDir::Readable, QDir::Writable, QDir::Executable y QDir::AllDirs: no hay indicadores equivalentes en QDirListing. Si necesitas esta funcionalidad, recorre las entradas con un bucle «range-for» y filtra según sea necesario.
    QDirIterator dit(dirPath, QDir::AllEntries | QDir::Readable | QDir::Executable | QDir::NoDotAndDotDot);
    while (dit.hasNext()) {
        const QFileInfo fi = dit.nextFileInfo();
        fileNames.append(fi.fileName());
        ...
    }
    
    using F = QDirListing::IteratorFlags;
    for (const auto &dirEntry : QDirListing(dirPath, F::Default)) {
        const QFileInfo fi = dirEntry.fileInfo();
        // Filter based on readable and executable bits
        if (fi.isReadable() && fi.isExecutable()) {
            fileNames.append(dirEntry.fileName());
            ...
        }
    }
    // QDir::AllDirs causes dirs to always be listed regardless of `nameFilters`;
    // for example, to list ".so" files in a file dialog and still list all dirs:
    QDirIterator dit(dirPath, nameFilters, QDir::AllDirs | QDir::NoDotAndDotDot);
    while (dit.hasNext()) {
        const QFileInfo fi = dit.nextFileInfo();
        ...
    }
    
    // Equivalent code using QDirListing:
    using F = QDirListing::IteratorFlags;
    for (const auto &dirEntry : QDirListing(dirPath, F::Default)) {
        const QFileInfo fi = dirEntry.fileInfo();
        if (fi.isDir() || fi.fileName().endsWith(".so"_L1)) {
            ...
        }
    }
  • Con QDirListing, la semántica de QDir::NoDot, QDir::NoDotDot y QDir::NoDotAndDotDot se ha combinado en un único indicador. Por defecto, QDirListing no muestra las entradas especiales . y ... Establece QDirListing::IteratorFlag::IncludeDotAndDotDot para mostrarlas.

Por defecto, QDirIterator resuelve los enlaces simbólicos a menos que se establezca QDir::NoSymlinks, mientras que QDirListing no resuelve los enlaces simbólicos a menos que se establezca QDirListing::IteratorFlag::ResolveSymlinks; en ese caso, el filtrado se realiza en función del tipo del destino del enlace simbólico, no del propio enlace simbólico. Por ejemplo, para mostrar únicamente archivos normales y enlaces simbólicos a archivos normales, debes establecer QDirListing::IteratorFlag::FilesOnly y QDirListing::IteratorFlag::ResolveSymlinks.

// Symbolic links are resolved by default
QDirIterator dit(dirPath, QDir::Files | QDir::NoDotAndDotDot);
while (dit.hasNext()) {
    const QFileInfo fi = dit.nextFileInfo();
    fileNames.append(fi.fileName());
    ...
}

// To preserve the behavior of the code above, set ResolveSymlinks:
using F = QDirListing::IteratorFlags;
for (const auto &dirEntry : QDirListing(dirPath, F::FilesOnly | F::ResolveSymlinks)) {
    fileNames.append(dirEntry.fileName());
    ...
}

QDirListing::DirEntry

QDirListing::DirEntry ofrece un subconjunto de la API de ` QFileInfo` (por ejemplo, `fileName()`, `filePath()`, `exists()`). La principal ventaja de la API de `DirEntry` es retrasar las llamadas (bastante costosas) a ` stat() ` o ` lstat() ` si ya hemos obtenido la información necesaria por otros medios. En Linux, por ejemplo, internamente utilizamos readdir() para recorrer un árbol de directorios, y obtenemos el nombre y el tipo de la entrada como parte de la información devuelta. Así que, si lo único que quieres es el nombre del archivo, utiliza QDirListing::DirEntry::fileName() en lugar de QDirListing::DirEntry::fileInfo().fileName() (QDirListing creará internamente un QFileInfo y lo utilizará de forma transparente cuando sea necesario).

© 2026 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.