qt 如何获取磁盘信息、QStorageInfo

以往获取qt磁盘信息，笔者是通过一下API转换的

BOOL GetDiskFreeSpaceExW([in, optional]  LPCWSTR         lpDirectoryName,[out, optional] PULARGE_INTEGER lpFreeBytesAvailableToCaller,[out, optional] PULARGE_INTEGER lpTotalNumberOfBytes,[out, optional] PULARGE_INTEGER lpTotalNumberOfFreeBytes
);

一次偶然的机会发现QT其实已经提供了相关类QStorageInfo

详细说明

QStorageInfo提供有关当前安装的存储和驱动器的信息。

允许检索有关卷的空间、挂载点、标签和文件系统名称的信息。

可以通过将卷挂载点的路径作为构造函数参数传递来创建QStorageInfo的实例，也可以使用setPath（）方法进行设置。静态挂载的卷 mountedVolumes()方法可用于获取所有挂载文件系统的列表。QStorageInfo总是缓存检索到的信息，可以调用refresh() 重置QStorageInfo的内部缓存。

以下示例打印有关它的信息。

    QList<QStorageInfo> list; = QStorageInfo::mountedVolumes();for(auto var:list){qDebug()<<"blockSize"<<":"<<var.blockSize();qDebug()<<"bytesAvailable"<<":"<<var.bytesAvailable()/1024/1024/1024<<"GB";qDebug()<<"bytesFree"<<":"<<var.bytesFree()/1024/1024/1024<<"GB";qDebug()<<"bytesTotal"<<":"<<var.bytesTotal()/1024/1024/1024<<"GB";qDebug()<<"device"<<":"<<var.device();qDebug()<<"displayName"<<":"<<var.displayName();qDebug()<<"fileSystemType"<<":"<<var.fileSystemType();qDebug()<<"isReadOnly"<<":"<<var.isReadOnly();qDebug()<<"isRoot"<<":"<<var.isRoot();qDebug()<<"isValid"<<":"<<var.isValid();qDebug()<<"name"<<":"<<var.name();qDebug()<<"rootPath"<<":"<<var.rootPath();qDebug()<<"*****************************";}

打印结果

blockSize : -1
bytesAvailable : 68 GB
bytesFree : 68 GB
bytesTotal : 146 GB
device : "\\\\?\\Volume{8406cabc-3eaa-4755-a85f-d9e977711c05}\\"
displayName : "Windows"
fileSystemType : "NTFS"
isReadOnly : false
isRoot : true
isValid : true
name : "Windows"
rootPath : "C:/"
*****************************
blockSize : -1
bytesAvailable : 209 GB
bytesFree : 209 GB
bytesTotal : 329 GB
device : "\\\\?\\Volume{84025fc9-a85f-445f-b128-36e702af5a5c}\\"
displayName : "Data"
fileSystemType : "NTFS"
isReadOnly : false
isRoot : false
isValid : true
name : "Data"
rootPath : "D:/"
*****************************

成员函数

QStorageInfo::QStorageInfo()

使用默认构造函数创建的对象将无效，因此无法使用。

See also setPath(), isReady(), and isValid().

QStorageInfo::QStorageInfo(const QString &path)

构造一个新的QStorageInfo对象，该对象提供有关安装在路径上的卷的信息。

如果传递目录或文件，QStorageInfo对象将引用此目录或文件所在的卷。您可以使用isValid（）方法检查创建的对象是否正确。

以下示例显示了如何获取应用程序所在的卷。建议始终检查卷是否已准备好且有效。

QStorageInfo var(qApp->applicationDirPath());if (var.isValid() && var.isReady()) {qDebug()<<"blockSize"<<":"<<var.blockSize();qDebug()<<"bytesAvailable"<<":"<<var.bytesAvailable()/1024/1024/1024<<"GB";qDebug()<<"bytesFree"<<":"<<var.bytesFree()/1024/1024/1024<<"GB";qDebug()<<"bytesTotal"<<":"<<var.bytesTotal()/1024/1024/1024<<"GB";qDebug()<<"device"<<":"<<var.device();qDebug()<<"displayName"<<":"<<var.displayName();qDebug()<<"fileSystemType"<<":"<<var.fileSystemType();qDebug()<<"isReadOnly"<<":"<<var.isReadOnly();qDebug()<<"isRoot"<<":"<<var.isRoot();qDebug()<<"isValid"<<":"<<var.isValid();qDebug()<<"name"<<":"<<var.name();qDebug()<<"rootPath"<<":"<<var.rootPath();}

打印结果

blockSize : -1
bytesAvailable : 209 GB
bytesFree : 209 GB
bytesTotal : 329 GB
device : "\\\\?\\Volume{84025fc9-a85f-445f-b128-36e702af5a5c}\\"
displayName : "Data"
fileSystemType : "NTFS"
isReadOnly : false
isRoot : false
isValid : true
name : "Data"
rootPath : "D:/"

See also setPath().

QStorageInfo::QStorageInfo(const QDir &dir)

构造一个新的QStorageInfo对象，该对象提供有关包含dir文件夹的卷的信息。

QStorageInfo::QStorageInfo(const QStorageInfo &other)

构造一个新的QStorageInfo对象，该对象是另一个QStorageInfo对象的副本。

QStorageInfo::~QStorageInfo()

销毁QStorageInfo对象并释放其资源。

int QStorageInfo::blockSize() const

返回此文件系统的最佳传输块大小。

如果QStorageInfo无法确定大小或QStorageInfo对象无效，则返回-1。

qint64 QStorageInfo::bytesAvailable() const

返回当前用户可用的大小（以字节为单位）。如果用户是root用户或系统管理员，它返回可用的总大小。

此大小可以小于或等于bytesFree（）函数返回的空闲大小。

如果QStorageInfo对象无效，则返回-1。

See also bytesTotal() and bytesFree().

qint64 QStorageInfo::bytesFree() const

返回卷中的可用字节数。请注意，如果文件系统上有配额，则此值可以大于 bytesAvailable()返回的值。

See also bytesTotal() and bytesAvailable().

qint64 QStorageInfo::bytesTotal() const

返回总体积大小（以字节为单位）。

See also bytesFree() and bytesAvailable().

QByteArray QStorageInfo::device() const

返回此卷的设备。

例如，在Unix文件系统（包括macOS）上，它返回本地存储的开发路径，如/dev/sda0。在Windows上，它返回本地存储的以\\\\?\\开头的UNC路径（换句话说，卷GUID）。

See also rootPath()

QString QStorageInfo::displayName() const

如果可用，则返回卷的名称，如果不可用，则返回根路径。

QByteArray QStorageInfo::fileSystemType() const

返回文件系统的类型名称。

这是一个依赖于平台的函数，文件系统名称可能因不同的操作系统而异。例如，在Windows文件系统上，它们可以命名为NTFS，Linux它们可以命名为ntfs-3g或fuseblk。

See also name().

bool QStorageInfo::isReadOnly() const

如果当前文件系统受到写入保护，则返回true；否则为假。

bool QStorageInfo::isReady() const

如果当前文件系统已准备好工作，则返回true；否则为假。例如，如果未插入CD卷，则返回false。

请注意，fileSystemType（）、name（）、bytesTotal（）、bytesFree（）和bytesAvailable() 将返回无效数据，直到卷准备就绪。

See also isValid()

bool QStorageInfo::isRoot() const

如果此QStorageInfo代表系统根卷，则返回true；否则为假。

在Unix文件系统上，根卷是安装在/上的卷。在Windows上，根卷是安装操作系统的卷。

See also root().

bool QStorageInfo::isValid() const

如果rootPath指定的QStorageInfo存在并正确挂载，则返回true。

See also isReady().

QList<QStorageInfo> QStorageInfo::mountedVolumes()

返回与当前挂载文件系统列表对应的QStorageInfo对象列表。

在Windows上，这会返回My Computer文件夹中可见的驱动器。在Unix操作系统上，它返回所有挂载文件系统的列表（伪文件系统除外）。

默认返回所有当前挂载的文件系统。

该示例显示了如何检索所有可用文件系统，跳过只读文件系统。

foreach (const QStorageInfo &var, QStorageInfo::mountedVolumes()) {if (var.isValid() && var.isReady()) {if (!var.isReadOnly()) {qDebug()<<"blockSize"<<":"<<var.blockSize();qDebug()<<"bytesAvailable"<<":"<<var.bytesAvailable()/1024/1024/1024<<"GB";qDebug()<<"bytesFree"<<":"<<var.bytesFree()/1024/1024/1024<<"GB";qDebug()<<"bytesTotal"<<":"<<var.bytesTotal()/1024/1024/1024<<"GB";qDebug()<<"device"<<":"<<var.device();qDebug()<<"displayName"<<":"<<var.displayName();qDebug()<<"fileSystemType"<<":"<<var.fileSystemType();qDebug()<<"isReadOnly"<<":"<<var.isReadOnly();qDebug()<<"isRoot"<<":"<<var.isRoot();qDebug()<<"isValid"<<":"<<var.isValid();qDebug()<<"name"<<":"<<var.name();qDebug()<<"rootPath"<<":"<<var.rootPath();}}}

打印结果

blockSize : -1
bytesAvailable : 68 GB
bytesFree : 68 GB
bytesTotal : 146 GB
device : "\\\\?\\Volume{8406cabc-3eaa-4755-a85f-d9e977711c05}\\"
displayName : "Windows"
fileSystemType : "NTFS"
isReadOnly : false
isRoot : true
isValid : true
name : "Windows"
rootPath : "C:/"
blockSize : -1
bytesAvailable : 209 GB
bytesFree : 209 GB
bytesTotal : 329 GB
device : "\\\\?\\Volume{84025fc9-a85f-445f-b128-36e702af5a5c}\\"
displayName : "Data"
fileSystemType : "NTFS"
isReadOnly : false
isRoot : false
isValid : true
name : "Data"
rootPath : "D:/"

See also root().

QString QStorageInfo::name() const

返回文件系统的人类可读名称，通常称为label。

并非所有文件系统都支持此功能。在这种情况下，此方法返回的值可能为空。如果文件系统不支持标签，或者没有设置标签，则返回一个空字符串。

在Linux，检索卷的标签需要udev出现在系统中。

See also fileSystemType().

void QStorageInfo::refresh()

重置QStorageInfo的内部缓存。

QStorageInfo缓存有关存储的信息以提高性能。QStorageInfo在对象构造期间和/或调用setPath（）方法时检索信息。您必须通过调用此函数来手动重置缓存以更新存储信息。

QStorageInfo QStorageInfo::root()

返回一个QStorageInfo对象，该对象表示系统根卷。

在Unix系统上，此调用返回根 ('/') 卷；在Windows中，则返回安装操作系统的卷。

See also isRoot().

QString QStorageInfo::rootPath() const

返回此QStorageInfo对象表示的文件系统的挂载点。

在Windows上，如果卷未挂载到目录，它会返回卷号。

请注意，rootPath（）返回的值是一个卷的真正挂载点，可能不等于传递给构造函数或setPath（）方法的值。例如，如果您在系统中只有根卷，并将'/directory'传递给setPath（），则此方法将返回'/'。

See also setPath() and device().

void QStorageInfo::setPath(const QString &path)

将此QStorageInfo对象设置为安装在path所在位置的文件系统。

path可以是文件系统的根路径、目录或该文件系统中的文件。

See also rootPath().

void QStorageInfo::swap(QStorageInfo &other)

将此卷信息与其他卷信息交换。此功能非常快，永远不会失败。

QStorageInfo &QStorageInfo::operator=(const QStorageInfo &other)

制作QStorageInfo对象的副本并将其分配给此QStorageInfo对象。

QStorageInfo &QStorageInfo::operator=(QStorageInfo &&other)

将其他分配给此QStorageInfo实例。