---

QStorageInfo 详解

前言

在开发需要处理文件存储、磁盘信息或空间管理的应用程序时，了解存储设备的相关信息非常重要。例如，在文件管理器中显示磁盘的总容量和剩余空间，或者在应用程序中验证可用空间是否足够保存文件。Qt 提供的 QStorageInfo 类专门用于获取这些信息。

QStorageInfo 提供了跨平台的接口，可以方便地获取存储设备的容量、可用空间、文件系统类型等信息，使开发者无需直接处理操作系统底层的存储管理接口。

---

什么是 QStorageInfo？

QStorageInfo 是 Qt 的一个类，用于获取系统存储设备的相关信息，包括：

1. 存储设备的总容量和可用空间。
2. 存储设备的挂载点、设备名称和文件系统类型。
3. 检查存储设备的可用性和只读状态。

典型应用场景包括：

• 显示磁盘容量和剩余空间。
• 检测设备是否已挂载或是否为只读设备。
• 验证存储空间是否足够完成某些操作。

---

QStorageInfo 的构造函数和常用成员函数

构造函数

1. 默认构造函数

• 函数原型：

  QStorageInfo();
  

• 作用：
  创建一个默认的 QStorageInfo 对象，不指向任何具体存储设备。

• 示例代码：

  QStorageInfo storageInfo;
  

2. 指定路径构造函数

• 函数原型：

  QStorageInfo(const QString &path);
  

• 作用：
  创建一个 QStorageInfo 对象，并与指定路径关联，获取其所在存储设备的信息。

• 参数：

  • path：文件或目录路径，用于标识目标存储设备。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  

---

常用成员函数

1. 获取存储设备根路径

rootPath

• 函数原型：

  QString rootPath() const;
  

• 作用：
  返回存储设备的根路径。

• 返回值：
  根路径字符串。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  qDebug() << "Root Path:" << storageInfo.rootPath();
  

---

2. 获取总容量

bytesTotal

• 函数原型：

  qint64 bytesTotal() const;
  

• 作用：
  返回存储设备的总容量（以字节为单位）。

• 返回值：
  存储设备的总容量。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  qDebug() << "Total Space:" << storageInfo.bytesTotal() / (1024 * 1024) << "MB";
  

---

3. 获取可用空间

bytesAvailable

• 函数原型：

  qint64 bytesAvailable() const;
  

• 作用：
  返回存储设备当前的可用空间（以字节为单位）。

• 返回值：
  存储设备的可用空间。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  qDebug() << "Available Space:" << storageInfo.bytesAvailable() / (1024 * 1024) << "MB";
  

---

4. 获取文件系统类型

fileSystemType

• 函数原型：

  QString fileSystemType() const;
  

• 作用：
  返回存储设备的文件系统类型（如 ext4, NTFS）。

• 返回值：
  文件系统类型的字符串。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  qDebug() << "File System Type:" << storageInfo.fileSystemType();
  

---

5. 获取设备名称

device

• 函数原型：

  QString device() const;
  

• 作用：
  返回存储设备的名称（设备标识）。

• 返回值：
  设备名称的字符串。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  qDebug() << "Device Name:" << storageInfo.device();
  

---

6. 检查设备是否挂载

isReady

• 函数原型：

  bool isReady() const;
  

• 作用：
  检查存储设备是否已挂载并准备好使用。

• 返回值：
  如果设备可用，返回 true；否则返回 false。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  if (storageInfo.isReady()) {qDebug() << "Storage is ready.";
  } else {qDebug() << "Storage is not ready.";
  }
  

---

7. 检查设备是否只读

isReadOnly

• 函数原型：

  bool isReadOnly() const;
  

• 作用：
  检查存储设备是否为只读模式。

• 返回值：
  如果设备是只读的，返回 true；否则返回 false。

• 示例代码：

  QStorageInfo storageInfo("/home/user/");
  if (storageInfo.isReadOnly()) {qDebug() << "Storage is read-only.";
  } else {qDebug() << "Storage is writable.";
  }
  

---

8. 获取所有存储设备信息

QStorageInfo::mountedVolumes

• 函数原型：

  static QList<QStorageInfo> mountedVolumes();
  

• 作用：
  返回系统中所有已挂载存储设备的信息。

• 返回值：
  一个 QList<QStorageInfo>，包含所有挂载的存储设备。

• 示例代码：

  QList<QStorageInfo> volumes = QStorageInfo::mountedVolumes();
  for (const QStorageInfo &volume : volumes) {qDebug() << "Device:" << volume.device();qDebug() << "Root Path:" << volume.rootPath();qDebug() << "File System:" << volume.fileSystemType();qDebug() << "Available Space:" << volume.bytesAvailable() / (1024 * 1024) << "MB";
  }
  

---

完整示例代码

以下示例展示了如何使用 QStorageInfo 获取当前存储设备的信息：

#include <QCoreApplication>
#include <QStorageInfo>
#include <QDebug>int main(int argc, char *argv[]) {QCoreApplication app(argc, argv);// 获取指定路径的存储信息QStorageInfo storageInfo("/home/user/");qDebug() << "Device Name:" << storageInfo.device();qDebug() << "Root Path:" << storageInfo.rootPath();qDebug() << "File System Type:" << storageInfo.fileSystemType();qDebug() << "Total Space:" << storageInfo.bytesTotal() / (1024 * 1024) << "MB";qDebug() << "Available Space:" << storageInfo.bytesAvailable() / (1024 * 1024) << "MB";qDebug() << "Is Read-Only:" << storageInfo.isReadOnly();qDebug() << "Is Ready:" << storageInfo.isReady();// 列出所有挂载的存储设备QList<QStorageInfo> volumes = QStorageInfo::mountedVolumes();for (const QStorageInfo &volume : volumes) {qDebug() << "Device:" << volume.device();qDebug() << "Root Path:" << volume.rootPath();qDebug() << "File System:" << volume.fileSystemType();qDebug() << "Available Space:" << volume.bytesAvailable() / (1024 * 1024) << "MB";}return 0;
}

---

总结

QStorageInfo 是一个强大的类，可以跨平台获取存储设备的信息，如总容量、可用空间、文件系统类型等。它的易用性和灵活性使得开发者能够轻松地管理存储设备的状态和使用情况。在需要显示磁盘信息、检查存储空间或验证设备状态的应用程序中，QStorageInfo 是一个理想的选择。

通过熟练掌握 QStorageInfo 的功能，开发者可以更加高效地处理存储管理相关的任务，并提升应用程序的用户体验。