QDirListing::DirEntry Class
class QDirListing::DirEntry- 所有成员的列表，包括继承的成员
- DirEntry 属于“输入/输出和网络”类。
公共函数
| QString | absoluteFilePath() const |
| QString | absolutePath() const |
| QString | baseName() const |
| QDateTime | birthTime(const QTimeZone &tz) const |
| QString | bundleName() const |
| QString | canonicalFilePath() const |
| QString | completeBaseName() const |
| QString | completeSuffix() const |
| bool | exists() const |
| QFileInfo | fileInfo() const |
| QString | fileName() const |
| QString | filePath() const |
| QDateTime | fileTime(QFileDevice::FileTime type, const QTimeZone &tz) const |
| bool | isDir() const |
| bool | isExecutable() const |
| bool | isFile() const |
| bool | isHidden() const |
| bool | isReadable() const |
| bool | isSymLink() const |
| bool | isWritable() const |
| QDateTime | lastModified(const QTimeZone &tz) const |
| QDateTime | lastRead(const QTimeZone &tz) const |
| QDateTime | metadataChangeTime(const QTimeZone &tz) const |
| qint64 | size() const |
| QString | suffix() const |
详细说明
对有效的QDirListing::const_iterator 进行解引用将返回一个DirEntry对象。
DirEntry 提供了QFileInfo API 的一部分（例如，fileName()、filePath()、exists()）。在内部，DirEntry 仅在需要时才构建QFileInfo 对象，即当其他系统函数尚未获取该信息时。您可以使用DirEntry::fileInfo() 来获取QFileInfo 。例如：
using ItFlag = QDirListing::IteratorFlag;
for (const auto &dirEntry : QDirListing(u"/etc"_s, ItFlag::Recursive)) {
// Faster
if (dirEntry.fileName().endsWith(u".conf")) { /* ... */ }
// This works, but might be potentially slower, since it has to construct a
// QFileInfo, whereas (depending on the implementation) the fileName could
// be known already
if (dirEntry.fileInfo().fileName().endsWith(u".conf")) { /* ... */ }
}
using ItFlag = QDirListing::IteratorFlag;
for (const auto &dirEntry : QDirListing(u"/etc"_s, ItFlag::Recursive)) {
// Both approaches are the same, because DirEntry will have to construct
// a QFileInfo to get this info (for example, by calling system stat())
if (dirEntry.size() >= 4'000 /* 4KB */) { /* ...*/ }
if (dirEntry.fileInfo().size() >= 4'000 /* 4KB */) { /* ... */ }
}成员函数文档
QDateTime DirEntry::birthTime(const QTimeZone &tz) const
QDateTime DirEntry::fileTime(QFileDevice::FileTime type, const QTimeZone &tz) const
QDateTime DirEntry::lastModified(const QTimeZone &tz) const
QDateTime DirEntry::lastRead(const QTimeZone &tz) const
QDateTime DirEntry::metadataChangeTime(const QTimeZone &tz) const
QFileInfo DirEntry::fileInfo() const
QString DirEntry::absoluteFilePath() const
QString DirEntry::absolutePath() const
QString DirEntry::baseName() const
QString DirEntry::bundleName() const
QString DirEntry::canonicalFilePath() const
QString DirEntry::completeBaseName() const
QString DirEntry::completeSuffix() const
QString DirEntry::fileName() const
QString DirEntry::filePath() const
QString DirEntry::suffix() const
bool DirEntry::exists() const
bool DirEntry::isDir() const
bool DirEntry::isExecutable() const
bool DirEntry::isFile() const
bool DirEntry::isHidden() const
bool DirEntry::isReadable() const
bool DirEntry::isSymLink() const
bool DirEntry::isWritable() const
qint64 DirEntry::size() const
请参阅QFileInfo 中同名的方法。
© 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.
