Public Functions
void	advance ()

void	checkAndPushDirectory (const QFileInfo &)

bool	entryMatches (const QString &fileName, const QFileInfo &fileInfo)

bool	matchesFilters (const QString &fileName, const QFileInfo &fi) const
	This convenience function implements the iterator's filtering logics and applies then to the current directory entry. More...

void	pushDirectory (const QFileInfo &fileInfo)

	QDirIteratorPrivate (const QFileSystemEntry &entry, const QStringList &nameFilters, QDir::Filters filters, QDirIterator::IteratorFlags flags, bool resolveEngine=true)

Public Variables
QFileInfo	currentFileInfo

QFileSystemEntry	dirEntry

QScopedPointer< QAbstractFileEngine >	engine

QDirIteratorPrivateIteratorStack< QAbstractFileEngineIterator >	fileEngineIterators

const QDir::Filters	filters

const QDirIterator::IteratorFlags	iteratorFlags

const QStringList	nameFilters

QVector< QRegExp >	nameRegExps

QDirIteratorPrivateIteratorStack< QFileSystemIterator >	nativeIterators

QFileInfo	nextFileInfo

QSet< QString >	visitedLinks

Detailed Description

Definition at line 126 of file qdiriterator.cpp.

Constructors and Destructors

◆ QDirIteratorPrivate()

QDirIteratorPrivate::QDirIteratorPrivate	(	const QFileSystemEntry &	entry,
		const QStringList &	nameFilters,
		QDir::Filters	filters,
		QDirIterator::IteratorFlags	flags,
		bool	resolveEngine = `true`
	)

Warning: This function is not part of the public interface.

Definition at line 165 of file qdiriterator.cpp.

Referenced by QDirIterator::QDirIterator().

     : dirEntry(entry)
       , nameFilters(nameFilters.contains(QLatin1String("*")) ? QStringList() : nameFilters)
       , filters(QDir::NoFilter == filters ? QDir::AllEntries : filters)
       , iteratorFlags(flags)
 {
 #ifndef QT_NO_REGEXP
     nameRegExps.reserve(nameFilters.size());
     for (int i = 0; i < nameFilters.size(); ++i)
         nameRegExps.append(
             QRegExp(nameFilters.at(i),
                     (filters & QDir::CaseSensitive) ? Qt::CaseSensitive : Qt::CaseInsensitive,
                     QRegExp::Wildcard));
 #endif
     QFileSystemMetaData metaData;
     if (resolveEngine)
         engine.reset(QFileSystemEngine::resolveEntryAndCreateLegacyEngine(dirEntry, metaData));
     QFileInfo fileInfo(new QFileInfoPrivate(dirEntry, metaData));
 
     // Populate fields for hasNext() and next()
     pushDirectory(fileInfo);
     advance();
 }

Functions

◆ advance()

void QDirIteratorPrivate::advance ( )

Warning: This function is not part of the public interface.

Definition at line 241 of file qdiriterator.cpp.

Referenced by QDirIterator::next(), and QDirIteratorPrivate().

 {
     if (engine) {
         while (!fileEngineIterators.isEmpty()) {
             // Find the next valid iterator that matches the filters.
             QAbstractFileEngineIterator *it;
             while (it = fileEngineIterators.top(), it->hasNext()) {
                 it->next();
                 if (entryMatches(it->currentFileName(), it->currentFileInfo()))
                     return;
             }
 
             fileEngineIterators.pop();
             delete it;
         }
     } else {
 #ifndef QT_NO_FILESYSTEMITERATOR
         QFileSystemEntry nextEntry;
         QFileSystemMetaData nextMetaData;
 
         while (!nativeIterators.isEmpty()) {
             // Find the next valid iterator that matches the filters.
             QFileSystemIterator *it;
             while (it = nativeIterators.top(), it->advance(nextEntry, nextMetaData)) {
                 QFileInfo info(new QFileInfoPrivate(nextEntry, nextMetaData));
 
                 if (entryMatches(nextEntry.fileName(), info))
                     return;
             }
 
             nativeIterators.pop();
             delete it;
         }
 #endif
     }
 
     currentFileInfo = nextFileInfo;
     nextFileInfo = QFileInfo();
 }

◆ checkAndPushDirectory()

void QDirIteratorPrivate::checkAndPushDirectory ( const QFileInfo & fileInfo )

Warning: This function is not part of the public interface.

Definition at line 284 of file qdiriterator.cpp.

Referenced by entryMatches().

 {
     // If we're doing flat iteration, we're done.
     if (!(iteratorFlags & QDirIterator::Subdirectories))
         return;
 
     // Never follow non-directory entries
     if (!fileInfo.isDir())
         return;
 
     // Follow symlinks only when asked
     if (!(iteratorFlags & QDirIterator::FollowSymlinks) && fileInfo.isSymLink())
         return;
 
     // Never follow . and ..
     QString fileName = fileInfo.fileName();
     if (QLatin1String(".") == fileName || QLatin1String("..") == fileName)
         return;
 
     // No hidden directories unless requested
     if (!(filters & QDir::AllDirs) && !(filters & QDir::Hidden) && fileInfo.isHidden())
         return;
 
     // Stop link loops
     if (!visitedLinks.isEmpty() &&
         visitedLinks.contains(fileInfo.canonicalFilePath()))
         return;
 
     pushDirectory(fileInfo);
 }

◆ entryMatches()

bool QDirIteratorPrivate::entryMatches	(	const QString &	fileName,
		const QFileInfo &	fileInfo
	)

inline

Definition at line 223 of file qdiriterator.cpp.

Referenced by advance().

 {
     checkAndPushDirectory(fileInfo);
 
     if (matchesFilters(fileName, fileInfo)) {
         currentFileInfo = nextFileInfo;
         nextFileInfo = fileInfo;
 
         //We found a matching entry.
         return true;
     }
 
     return false;
 }

◆ matchesFilters()

bool QDirIteratorPrivate::matchesFilters	(	const QString &	fileName,
		const QFileInfo &	fi
	)		const

This convenience function implements the iterator's filtering logics and applies then to the current directory entry.

Warning: This function is not part of the public interface.

It returns true if the current entry matches the filters (i.e., the current entry will be returned as part of the directory iteration); otherwise, false is returned.

Definition at line 329 of file qdiriterator.cpp.

Referenced by entryMatches().

 {
     Q_ASSERT(!fileName.isEmpty());
 
     // filter . and ..?
     const int fileNameSize = fileName.size();
     const bool dotOrDotDot = fileName[0] == QLatin1Char('.')
                              && ((fileNameSize == 1)
                                  ||(fileNameSize == 2 && fileName[1] == QLatin1Char('.')));
     if ((filters & QDir::NoDot) && dotOrDotDot && fileNameSize == 1)
         return false;
     if ((filters & QDir::NoDotDot) && dotOrDotDot && fileNameSize == 2)
         return false;
     if ((filters & QDir::NoDotAndDotDot) && dotOrDotDot) // ### Qt5 remove (NoDotAndDotDot == NoDot|NoDotDot)
         return false;
 
     // name filter
 #ifndef QT_NO_REGEXP
     // Pass all entries through name filters, except dirs if the AllDirs
     if (!nameFilters.isEmpty() && !((filters & QDir::AllDirs) && fi.isDir())) {
         bool matched = false;
         for (QVector<QRegExp>::const_iterator iter = nameRegExps.constBegin(),
                                               end = nameRegExps.constEnd();
                 iter != end; ++iter) {
 
             if (iter->exactMatch(fileName)) {
                 matched = true;
                 break;
             }
         }
         if (!matched)
             return false;
     }
 #endif
     // skip symlinks
     const bool skipSymlinks = (filters & QDir::NoSymLinks);
     const bool includeSystem = (filters & QDir::System);
     if(skipSymlinks && fi.isSymLink()) {
         // The only reason to save this file is if it is a broken link and we are requesting system files.
         if(!includeSystem || fi.exists())
             return false;
     }
 
     // filter hidden
     const bool includeHidden = (filters & QDir::Hidden);
     if (!includeHidden && !dotOrDotDot && fi.isHidden())
         return false;
 
     // filter system files
     if (!includeSystem && (!(fi.isFile() || fi.isDir() || fi.isSymLink())
                     || (!fi.exists() && fi.isSymLink())))
         return false;
 
     // skip directories
     const bool skipDirs = !(filters & (QDir::Dirs | QDir::AllDirs));
     if (skipDirs && fi.isDir())
         return false;
 
     // skip files
     const bool skipFiles    = !(filters & QDir::Files);
     if (skipFiles && fi.isFile())
         // Basically we need a reason not to exclude this file otherwise we just eliminate it.
         return false;
 
     // filter permissions
     const bool filterPermissions = ((filters & QDir::PermissionMask)
                                     && (filters & QDir::PermissionMask) != QDir::PermissionMask);
     const bool doWritable = !filterPermissions || (filters & QDir::Writable);
     const bool doExecutable = !filterPermissions || (filters & QDir::Executable);
     const bool doReadable = !filterPermissions || (filters & QDir::Readable);
     if (filterPermissions
         && ((doReadable && !fi.isReadable())
             || (doWritable && !fi.isWritable())
             || (doExecutable && !fi.isExecutable()))) {
         return false;
     }
 
     return true;
 }

◆ pushDirectory()

void QDirIteratorPrivate::pushDirectory ( const QFileInfo & fileInfo )

Warning: This function is not part of the public interface.

Definition at line 193 of file qdiriterator.cpp.

Referenced by checkAndPushDirectory(), and QDirIteratorPrivate().

 {
     QString path = fileInfo.filePath();
 
 #ifdef Q_OS_WIN
     if (fileInfo.isSymLink())
         path = fileInfo.canonicalFilePath();
 #endif
 
     if (iteratorFlags & QDirIterator::FollowSymlinks)
         visitedLinks << fileInfo.canonicalFilePath();
 
     if (engine) {
         engine->setFileName(path);
         QAbstractFileEngineIterator *it = engine->beginEntryList(filters, nameFilters);
         if (it) {
             it->setPath(path);
             fileEngineIterators << it;
         } else {
             // No iterator; no entry list.
         }
     } else {
 #ifndef QT_NO_FILESYSTEMITERATOR
         QFileSystemIterator *it = new QFileSystemIterator(fileInfo.d_ptr->fileEntry,
             filters, nameFilters, iteratorFlags);
         nativeIterators << it;
 #endif
     }
 }