以往获取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实例。
相关非成员函数
bool operator!=(const QStorageInfo &first, const QStorageInfo &second)
如果第一个QStorageInfo对象引用的驱动器或卷与第二个不同,则返回true;否则返回false
bool operator==(const QStorageInfo &first, const QStorageInfo &second)
如果第一个QStorageInfo对象引用与第二个相同的驱动器或卷,则返回true;否则返回false。
请注意,比较两个无效的QStorageInfo对象的结果始终为正。