QDirListing Class

Documentación de las funciones miembro

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

Construye un QDirListing que puede iterar sobre path.

Puedes pasar opciones a través de flags para controlar cómo debe ser iterado el directorio.

Por defecto, flags es IteratorFlag::Default.

Ver también IteratorFlags.

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

Construye un QDirListing que puede iterar sobre path.

Puedes pasar opciones a través de flags para controlar cómo debe ser iterado el directorio. Por defecto, flags es IteratorFlag::Default.

Las entradas listadas serán filtradas de acuerdo a los patrones glob de archivo en nameFilters, los cuales son convertidos a una expresión regular usando QRegularExpression::fromWildcard (ver QDir::setNameFilters() para más detalles).

Por ejemplo, el siguiente iterador podría utilizarse para iterar sobre archivos de audio:

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

A veces se puede filtrar por nombre de forma más eficiente iterando sobre las entradas con un bucle range-for, utilizando la comparación de cadenas. Por ejemplo:

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

Véase también IteratorFlags y QDir::setNameFilters().

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

Constructor Move. Mueve other dentro de este QDirListing.

[noexcept] QDirListing::~QDirListing()

Destruye el QDirListing.

(c)begin() devuelve un QDirListing::const_iterator que puede utilizarse para iterar sobre las entradas del directorio.

• Se trata de un iterador de una sola pasada (no se pueden iterar las entradas de directorio en orden inverso).
• No se puede copiar, sólo std::move()d.
• El valor de retorno de post-incremento en objetos que modelan std::input_iterator está parcialmente formado (una copia de un iterador que ya ha sido avanzado), las únicas operaciones válidas sobre un objeto de este tipo son la destrucción y la asignación de un nuevo iterador. Por lo tanto, el operador post-incremento avanza el iterador y devuelve void.
• No permite el acceso aleatorio
• Puede utilizarse en bucles ranged-for; o con algoritmos std::ranges de C++20 que no requieran iteradores de acceso aleatorio
• La desreferenciación de un iterador válido devuelve a const DirEntry &
• (c)end() devuelve un QDirListing::sentinel que señala el final de la iteración. Desreferenciar un iterador que compara igual a end() es un comportamiento indefinido

(Algunas de las restricciones anteriores vienen dictadas por la implementación de las funciones de la biblioteca del sistema subyacente).

Por ejemplo:

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

He aquí cómo encontrar y leer todos los ficheros filtrados por nombre, recursivamente:

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::SóloLectura))        qDebug() << f.fileName() << f.readAll().trimmed().toDouble() / 1000 << "MHz";
}

Véase también QDirListing::DirEntry.

QDirListing::IteratorFlags QDirListing::iteratorFlags() const

Devuelve el conjunto de IteratorFlags utilizado para construir este QDirListing.

QString QDirListing::iteratorPath() const

Devuelve la ruta del directorio utilizado para construir este QDirListing.

QStringList QDirListing::nameFilters() const

Devuelve la lista de filtros glob de nombres de archivo utilizados para construir este QDirListing.

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

Mover-asigna other a este QDirListing.