qfileinfo.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtCore module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QFILEINFO_H
  38. #define QFILEINFO_H
  39. #include <QtCore/qfile.h>
  40. #include <QtCore/qlist.h>
  41. QT_BEGIN_HEADER
  42. QT_BEGIN_NAMESPACE
  43. QT_MODULE(Core)
  44. class QDir;
  45. class QDateTime;
  46. class QFileInfoPrivate;
  47. class Q_CORE_EXPORT QFileInfo
  48. {
  49. public:
  50.     QFileInfo();
  51.     QFileInfo(const QString &file);
  52.     QFileInfo(const QFile &file);
  53.     QFileInfo(const QDir &dir, const QString &file);
  54.     QFileInfo(const QFileInfo &fileinfo);
  55.     ~QFileInfo();
  56.     QFileInfo &operator=(const QFileInfo &fileinfo);
  57.     bool operator==(const QFileInfo &fileinfo); // 5.0 - remove me
  58.     bool operator==(const QFileInfo &fileinfo) const;
  59.     inline bool operator!=(const QFileInfo &fileinfo) { return !(operator==(fileinfo)); } // 5.0 - remove me
  60.     inline bool operator!=(const QFileInfo &fileinfo) const { return !(operator==(fileinfo)); }
  61.     void setFile(const QString &file);
  62.     void setFile(const QFile &file);
  63.     void setFile(const QDir &dir, const QString &file);
  64.     bool exists() const;
  65.     void refresh();
  66.     QString filePath() const;
  67.     QString absoluteFilePath() const;
  68.     QString canonicalFilePath() const;
  69.     QString fileName() const;
  70.     QString baseName() const;
  71.     QString completeBaseName() const;
  72.     QString suffix() const;
  73.     QString bundleName() const;
  74.     QString completeSuffix() const;
  75.     QString path() const;
  76.     QString absolutePath() const;
  77.     QString canonicalPath() const;
  78.     QDir dir() const;
  79.     QDir absoluteDir() const;
  80.     bool isReadable() const;
  81.     bool isWritable() const;
  82.     bool isExecutable() const;
  83.     bool isHidden() const;
  84.     bool isRelative() const;
  85.     inline bool isAbsolute() const { return !isRelative(); }
  86.     bool makeAbsolute();
  87.     bool isFile() const;
  88.     bool isDir() const;
  89.     bool isSymLink() const;
  90.     bool isRoot() const;
  91.     bool isBundle() const;
  92.     QString readLink() const;
  93.     inline QString symLinkTarget() const { return readLink(); }
  94.     QString owner() const;
  95.     uint ownerId() const;
  96.     QString group() const;
  97.     uint groupId() const;
  98.     bool permission(QFile::Permissions permissions) const;
  99.     QFile::Permissions permissions() const;
  100.     qint64 size() const;
  101.     QDateTime created() const;
  102.     QDateTime lastModified() const;
  103.     QDateTime lastRead() const;
  104.     void detach();
  105.     bool caching() const;
  106.     void setCaching(bool on);
  107. #ifdef QT3_SUPPORT
  108.     enum Permission {
  109.         ReadOwner = QFile::ReadOwner, WriteOwner = QFile::WriteOwner, ExeOwner = QFile::ExeOwner,
  110.         ReadUser  = QFile::ReadUser,  WriteUser  = QFile::WriteUser,  ExeUser  = QFile::ExeUser,
  111.         ReadGroup = QFile::ReadGroup, WriteGroup = QFile::WriteGroup, ExeGroup = QFile::ExeGroup,
  112.         ReadOther = QFile::ReadOther, WriteOther = QFile::WriteOther, ExeOther = QFile::ExeOther
  113.     };
  114.     Q_DECLARE_FLAGS(PermissionSpec, Permission)
  115.     inline QT3_SUPPORT QString baseName(bool complete) {
  116.         if(complete)
  117.             return completeBaseName();
  118.         return baseName();
  119.     }
  120.     inline QT3_SUPPORT QString extension(bool complete = true) const {
  121.         if(complete)
  122.             return completeSuffix();
  123.         return suffix();
  124.     }
  125.     inline QT3_SUPPORT QString absFilePath() const { return absoluteFilePath(); }
  126.     inline QT3_SUPPORT QString dirPath(bool absPath = false) const {
  127.         if(absPath)
  128.             return absolutePath();
  129.         return path();
  130.     }
  131.     QT3_SUPPORT QDir dir(bool absPath) const;
  132.     inline QT3_SUPPORT bool convertToAbs() { return makeAbsolute(); }
  133. #if !defined(Q_NO_TYPESAFE_FLAGS)
  134.     inline QT3_SUPPORT bool permission(PermissionSpec permissions) const
  135.     { return permission(QFile::Permissions(static_cast<int>(permissions))); }
  136. #endif
  137. #endif
  138. protected:
  139.     QFileInfoPrivate *d_ptr;
  140. private:
  141.     Q_DECLARE_PRIVATE(QFileInfo)
  142. };
  143. Q_DECLARE_TYPEINFO(QFileInfo, Q_MOVABLE_TYPE);
  144. #ifdef QT3_SUPPORT
  145. Q_DECLARE_OPERATORS_FOR_FLAGS(QFileInfo::PermissionSpec)
  146. #endif
  147. typedef QList<QFileInfo> QFileInfoList;
  148. #ifdef QT3_SUPPORT
  149. typedef QList<QFileInfo>::Iterator QFileInfoListIterator;
  150. #endif
  151. QT_END_NAMESPACE
  152. QT_END_HEADER
  153. #endif // QFILEINFO_H