CopperSpice API  1.8.1
QDirIterator Class Reference

The QDirIterator class provides an iterator for directory entrylists. More...

Public Typedefs

using IteratorFlags = QFlags< IteratorFlag >
 

Public Types

enum  IteratorFlag
 

Public Methods

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

Friends

class QDir
 

Detailed Description

The QDirIterator class provides an iterator for directory entrylists.

You can use QDirIterator to navigate entries of a directory one at a time. It is similar to QDir::entryList() and QDir::entryInfoList(), but because it lists entries one at a time instead of all at once, it scales better and is more suitable for large directories. It also supports listing directory contents recursively, and following symbolic links. Unlike QDir::entryList(), QDirIterator does not support sorting.

The QDirIterator constructor takes a QDir or a directory as argument. After construction, the iterator is located before the first directory entry. Here is how to iterate over all the entries sequentially:

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

The next() function returns the path to the next directory entry and advances the iterator. You can also call filePath() to get the current file path without advancing the iterator. The fileName() function returns only the name of the file, similar to how QDir::entryList() works. You can also call fileInfo() to get a QFileInfo for the current entry.

Unlike the CopperSpice container iterators, QDirIterator is uni-directional (i.e., you can not iterate directories in reverse order) and does not allow random access.

QDirIterator works with all supported file engines, and is implemented using QAbstractFileEngineIterator.

See also
QDir, QDir::entryList(), QAbstractFileEngineIterator

Member Typedef Documentation

Member Enumeration Documentation

This enum describes flags that you can combine to configure the behavior of QDirIterator.

ConstantValueDescription
QDirIterator::NoIteratorFlags0x0The default value, representing no flags. The iterator will return entries for the assigned path.
QDirIterator::Subdirectories0x2List entries inside all subdirectories as well.
QDirIterator::FollowSymlinks0x1 When combined with Subdirectories this flag enables iterating through all subdirectories of the assigned path following all symbolic links. Symbolic link loops are automatically detected and ignored.

Constructor & Destructor Documentation

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

Constructs a QDirIterator that can iterate over dir's entrylist, using dir's name filters and regular filters. You can pass options via flags to decide how the directory should be iterated.

By default, flags is NoIteratorFlags, which provides the same behavior as in QDir::entryList().

The sorting in dir is ignored.

Note
To list symlinks that point to non existing files, QDir::System must be passed to the flags.
See also
hasNext(), next(), IteratorFlags
QDirIterator::QDirIterator ( const QString path,
IteratorFlags  flags = NoIteratorFlags 
)

Constructs a QDirIterator that can iterate over path. You can pass options via flags to decide how the directory should be iterated.

By default, flags is NoIteratorFlags, which provides the same behavior as in QDir::entryList().

Note
To list symlinks that point to non existing files, QDir::System must be passed to the flags.
See also
hasNext(), next(), IteratorFlags
QDirIterator::QDirIterator ( const QString path,
QDir::Filters  filters,
IteratorFlags  flags = NoIteratorFlags 
)

Constructs a QDirIterator that can iterate over path, with no name filtering and filters for entry filtering. You can pass options via flags to decide how the directory should be iterated.

By default, filters is QDir::NoFilter, and flags is NoIteratorFlags, which provides the same behavior as in QDir::entryList().

Note
To list symlinks that point to non existing files, QDir::System must be passed to the flags.
See also
hasNext(), next(), IteratorFlags
QDirIterator::QDirIterator ( const QString path,
const QStringList nameFilters,
QDir::Filters  filters = QDir::NoFilter,
IteratorFlags  flags = NoIteratorFlags 
)

Constructs a QDirIterator that can iterate over path, using nameFilters and filters. You can pass options via flags to decide how the directory should be iterated.

By default, flags is NoIteratorFlags, which provides the same behavior as QDir::entryList().

Note
To list symlinks that point to non existing files, QDir::System must be passed to the flags.
See also
hasNext(), next(), IteratorFlags
QDirIterator::~QDirIterator ( )

Destroys the QDirIterator.

Method Documentation

QFileInfo QDirIterator::fileInfo ( ) const

Returns a QFileInfo for the current directory entry.

See also
filePath(), fileName()
QString QDirIterator::fileName ( ) const

Returns the file name for the current directory entry, without the path prepended.

This function is convenient when iterating a single directory. When using the QDirIterator::Subdirectories flag, you can use filePath() to get the full path.

See also
filePath(), fileInfo()
QString QDirIterator::filePath ( ) const

Returns the full file path for the current directory entry.

See also
fileInfo(), fileName()
bool QDirIterator::hasNext ( ) const

Returns true if there is at least one more entry in the directory otherwise false is returned.

See also
next(), fileName(), filePath(), fileInfo()
QString QDirIterator::next ( )

Advances the iterator to the next entry, and returns the file path of this new entry. If hasNext() returns false, this function does nothing, and returns a null QString.

You can call fileName() or filePath() to get the current entry file name or path, or fileInfo() to get a QFileInfo for the current entry.

See also
hasNext(), fileName(), filePath(), fileInfo()
QString QDirIterator::path ( ) const

Returns the base directory of the iterator.