En esta página

QDirIterator Class

La clase QDirIterator proporciona un iterador para las listas de entradas de los directorios. Más información...

Encabezado: #include <QDirIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Tipos públicos

enum IteratorFlag { NoIteratorFlags, Subdirectories, FollowSymlinks }
flags IteratorFlags

Funciones públicas

QDirIterator(const QDir &dir, QDirIterator::IteratorFlags flags = NoIteratorFlags)
QDirIterator(const QString &path, QDirIterator::IteratorFlags flags = NoIteratorFlags)
QDirIterator(const QString &path, QDir::Filters filters, QDirIterator::IteratorFlags flags = NoIteratorFlags)
QDirIterator(const QString &path, const QStringList &nameFilters, QDir::Filters filters = QDir::NoFilter, QDirIterator::IteratorFlags flags = NoIteratorFlags)
~QDirIterator()
QFileInfo fileInfo() const
QString fileName() const
QString filePath() const
bool hasNext() const
QString next()
(since 6.3) QFileInfo nextFileInfo()
QString path() const

Descripción detallada

Puedes utilizar QDirIterator para recorrer las entradas de un directorio de una en una. Es similar a QDir::entryList() y QDir::entryInfoList(), pero, dado que muestra las entradas una a una en lugar de todas a la vez, se adapta mejor y resulta más adecuado para directorios de gran tamaño. También permite mostrar el contenido de los directorios de forma recursiva y seguir enlaces simbólicos. A diferencia de QDir::entryList(), QDirIterator no admite la ordenación.

El constructor de QDirIterator toma como argumento un ` QDir ` o un directorio. Tras la construcción, el iterador se sitúa antes de la primera entrada del directorio. A continuación se muestra cómo recorrer todas las entradas de forma secuencial:

QDirIterator it("/etc", QDirIterator::Subdirectories);
while (it.hasNext()) {
    QString dir = it.next();
    qDebug() << dir;
   // /etc/.
    // /etc/..
    // /etc/X11
    // /etc/X11/fs
    // ...
}

A continuación se explica cómo buscar y leer todos los archivos filtrados por nombre, de forma recursiva:

QDirIterator it("/sys", QStringList() << "scaling_cur_freq", QDir::NoFilter, QDirIterator::Subdirectories);
while (it.hasNext()) {
    QFile f(it.next());
    f.open(QIODevice::ReadOnly);
    qDebug() << f.fileName() << f.readAll().trimmed().toDouble() / 1000 << "MHz";
}

Las funciones ` next()` y ` nextFileInfo()` hacen avanzar el iterador y devuelven la ruta o el ` QFileInfo ` de la siguiente entrada del directorio. También puedes llamar a ` filePath()` o ` fileInfo()` para obtener la ruta actual del archivo o el ` QFileInfo ` sin necesidad de hacer avanzar primero el iterador. La función ` fileName()` devuelve únicamente el nombre del archivo, de forma similar a como funciona ` QDir::entryList()`.

A diferencia de los iteradores de contenedores de Qt, QDirIterator es unidireccional (es decir, no se puede recorrer los directorios en orden inverso) y no permite el acceso aleatorio.

Nota: Esta clase está obsoleta y podría eliminarse en una futura versión de Qt. Utiliza en su lugar ` QDirListing `; consulta «Portar QDirIterator a QDirListing».

Véase también ` QDir ` y ` QDir::entryList()`.

Documentación sobre los tipos de miembros

enum QDirIterator::IteratorFlag
flags QDirIterator::IteratorFlags

Esta enumeración describe los indicadores que se pueden combinar para configurar el comportamiento de QDirIterator.

ConstanteValorDescripción
QDirIterator::NoIteratorFlags0x0El valor por defecto, que representa la ausencia de indicadores. El iterador devolverá las entradas de la ruta asignada.
QDirIterator::Subdirectories0x2Incluye también las entradas de todos los subdirectorios.
QDirIterator::FollowSymlinks0x1Cuando se combina con «Subdirectorios», este indicador permite recorrer todos los subdirectorios de la ruta asignada, siguiendo todos los enlaces simbólicos. Los bucles de enlaces simbólicos (por ejemplo, «link» => «.» o «link» => «..») se detectan automáticamente y se ignoran.

El tipo «IteratorFlags» es un «typedef» para «QFlags<IteratorFlag>». Almacena una combinación OR de valores de «IteratorFlag».

Documentación de las funciones miembro

QDirIterator::QDirIterator(const QDir &dir, QDirIterator::IteratorFlags flags = NoIteratorFlags)

Crea un QDirIterator capaz de recorrer la lista de entradas de dir, utilizando los filtros de nombres y los filtros regulares de dir. Se pueden pasar opciones a través de flags para determinar cómo se debe recorrer el directorio.

Por defecto, flags es NoIteratorFlags, lo que proporciona el mismo comportamiento que en QDir::entryList().

Se ignora el orden de clasificación en ` dir `.

Nota: Para mostrar enlaces simbólicos que apuntan a archivos que no existen, se debe pasar QDir::System a los parámetros.

Véase también hasNext(), next() y IteratorFlags.

QDirIterator::QDirIterator(const QString &path, QDirIterator::IteratorFlags flags = NoIteratorFlags)

Crea un QDirIterator capaz de recorrer path. Se pueden pasar opciones mediante flags para determinar cómo se debe recorrer el directorio.

Por defecto, flags es NoIteratorFlags, lo que proporciona el mismo comportamiento que en QDir::entryList().

Nota: Para mostrar los enlaces simbólicos que apuntan a archivos que no existen, se debe pasar QDir::System a las opciones.

Véase también hasNext(), next() y IteratorFlags.

QDirIterator::QDirIterator(const QString &path, QDir::Filters filters, QDirIterator::IteratorFlags flags = NoIteratorFlags)

Crea un QDirIterator capaz de recorrer path, sin filtrado por nombre y utilizando filters como filtro de entradas. Se pueden pasar opciones a través de flags para determinar cómo se debe recorrer el directorio.

Por defecto, filters es QDir::NoFilter y flags es NoIteratorFlags, lo que proporciona el mismo comportamiento que en QDir::entryList().

Nota: Para mostrar los enlaces simbólicos que apuntan a archivos que no existen, se debe pasar QDir::System a los parámetros.

Véase también hasNext(), next() y IteratorFlags.

QDirIterator::QDirIterator(const QString &path, const QStringList &nameFilters, QDir::Filters filters = QDir::NoFilter, QDirIterator::IteratorFlags flags = NoIteratorFlags)

Crea un QDirIterator capaz de recorrer path, utilizando nameFilters y filters. Se pueden pasar opciones a través de flags para determinar cómo se debe recorrer el directorio.

Por defecto, flags es NoIteratorFlags, lo que proporciona el mismo comportamiento que QDir::entryList().

Por ejemplo, se podría utilizar el siguiente iterador para recorrer los archivos de audio:

QDirIterator audioFileIt(audioPath, {"*.mp3", "*.wav"}, QDir::Files);

Nota: Para mostrar los enlaces simbólicos que apuntan a archivos que no existen, se debe pasar ` QDir::System ` a los parámetros.

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

[noexcept] QDirIterator::~QDirIterator()

Destruye el « QDirIterator ».

QFileInfo QDirIterator::fileInfo() const

Devuelve un objeto ` QFileInfo ` correspondiente a la entrada del directorio actual.

Véase también filePath() y fileName().

QString QDirIterator::fileName() const

Devuelve el nombre del archivo correspondiente a la entrada del directorio actual, sin la ruta inicial.

Esta función resulta útil al recorrer un único directorio. Si se utiliza la bandera « QDirIterator::Subdirectories », se puede emplear la función « filePath()» para obtener la ruta completa.

Véanse también filePath() y fileInfo().

QString QDirIterator::filePath() const

Devuelve la ruta completa del archivo correspondiente a la entrada del directorio actual.

Véanse también ` fileInfo()` y ` fileName()`.

bool QDirIterator::hasNext() const

Devuelve « true » si hay al menos una entrada más en el directorio; en caso contrario, devuelve «false».

Véase también next(), nextFileInfo(), fileName(), filePath() y fileInfo().

QString QDirIterator::next()

Avanza el iterador a la siguiente entrada y devuelve la ruta del archivo de esta nueva entrada. Si hasNext() devuelve false, esta función no realiza ninguna acción y devuelve un QString vacío. Lo ideal es llamar siempre a hasNext() antes de llamar a este método.

Puedes llamar a ` fileName()` o a ` filePath()` para obtener el nombre o la ruta del archivo de la entrada actual, o a ` fileInfo()` para obtener un ` QFileInfo ` de la entrada actual.

Llama a ` nextFileInfo()` en lugar de `next()` si te interesa el ` QFileInfo`.

Véase también hasNext(), nextFileInfo(), fileName(), filePath() y fileInfo().

[since 6.3] QFileInfo QDirIterator::nextFileInfo()

Avanza el iterador a la siguiente entrada y devuelve la información del archivo de esta nueva entrada. Si hasNext() devuelve false, esta función no realiza ninguna acción y devuelve un QFileInfo vacío. Lo ideal es llamar siempre a hasNext() antes de llamar a este método.

Puedes llamar a ` fileName()` o a ` filePath()` para obtener el nombre o la ruta del archivo de la entrada actual, o a ` fileInfo()` para obtener un ` QFileInfo ` para la entrada actual.

Llama a ` next()` en lugar de `nextFileInfo()` cuando lo único que necesites sea el ` filePath()`.

Esta función se introdujo en Qt 6.3.

Véase también hasNext(), fileName(), filePath() y fileInfo().

QString QDirIterator::path() const

Devuelve el directorio base del iterador.

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