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-3gfuseblk。 

 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对象的结果始终为正。 

  

  • 23
    点赞
  • 26
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

春意盎然的三月

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值