QStorageInfo ¶

概要 ¶

详细描述 ¶

Allows retrieving information about the volume’s space, its mount point, label, and filesystem name.

You can create an instance of QStorageInfo by passing the path to the volume’s mount point as a constructor parameter, or you can set it using the setPath() method. The static mountedVolumes() method can be used to get the list of all mounted filesystems.

QStorageInfo always caches the retrieved information, but you can call refresh() to invalidate the cache.

The following example retrieves the most common information about the root volume of the system, and prints information about it.

QStorageInfo storage = QStorageInfo::root();
qDebug() << storage.rootPath();
if (storage.isReadOnly())
    qDebug() << "isReadOnly:" << storage.isReadOnly();
qDebug() << "name:" << storage.name();
qDebug() << "fileSystemType:" << storage.fileSystemType();
qDebug() << "size:" << storage.bytesTotal()/1000/1000 << "MB";
qDebug() << "availableSize:" << storage.bytesAvailable()/1000/1000 << "MB";
											

class QStorageInfo ¶

QStorageInfo(dir)

QStorageInfo(other)

QStorageInfo(path)

param dir

QDir

param path

unicode

param other

QStorageInfo

构造空 QStorageInfo 对象。

Objects created with the default constructor will be invalid and therefore not ready for use.

另请参阅

setPath() isReady() isValid()

PySide2.QtCore.QStorageInfo. blockSize ( ) ¶

返回类型

int

Returns the optimal transfer block size for this filesystem.

返回 -1，若 QStorageInfo could not determine the size or if the QStorageInfo 对象是无效的。

PySide2.QtCore.QStorageInfo. bytesAvailable ( ) ¶

返回类型

qint64

Returns the size (in bytes) available for the current user. It returns the total size available if the user is the root user or a system administrator.

This size can be less than or equal to the free size returned by bytesFree() 函数。

返回 -1，若 QStorageInfo 对象是无效的。

另请参阅

bytesTotal() bytesFree()

PySide2.QtCore.QStorageInfo. bytesFree ( ) ¶

返回类型

qint64

Returns the number of free bytes in a volume. Note that if there are quotas on the filesystem, this value can be larger than the value returned by bytesAvailable() .

返回 -1，若 QStorageInfo 对象是无效的。

另请参阅

bytesTotal() bytesAvailable()

PySide2.QtCore.QStorageInfo. bytesTotal ( ) ¶

返回类型

qint64

Returns the total volume size in bytes.

返回 -1，若 QStorageInfo 对象是无效的。

另请参阅

bytesFree() bytesAvailable()

PySide2.QtCore.QStorageInfo. device ( ) ¶

返回类型

QByteArray

Returns the device for this volume.

For example, on Unix filesystems (including macOS), this returns the devpath like /dev/sda0 for local storages. On Windows, it returns the UNC path starting with \\\\?\\ for local storages (in other words, the volume GUID).

另请参阅

rootPath() subvolume()

PySide2.QtCore.QStorageInfo. displayName ( ) ¶

返回类型

unicode

Returns the volume’s name, if available, or the root path if not.

PySide2.QtCore.QStorageInfo. fileSystemType ( ) ¶

返回类型

QByteArray

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

This is a platform-dependent function, and filesystem names can vary between different operating systems. For example, on Windows filesystems they can be named NTFS , and on Linux they can be named ntfs-3g or fuseblk .

另请参阅

name()

PySide2.QtCore.QStorageInfo. isReadOnly ( ) ¶

返回类型

bool

Returns true if the current filesystem is protected from writing; false otherwise.

PySide2.QtCore.QStorageInfo. isReady ( ) ¶

返回类型

bool

Returns true if the current filesystem is ready to work; false otherwise. For example, false is returned if the CD volume is not inserted.

注意： fileSystemType() , name() , bytesTotal() , bytesFree() ，和 bytesAvailable() will return invalid data until the volume is ready.

另请参阅

isValid()

PySide2.QtCore.QStorageInfo. isRoot ( ) ¶

返回类型

bool

返回 true，若此 QStorageInfo represents the system root volume; false otherwise.

On Unix filesystems, the root volume is a volume mounted on / . On Windows, the root volume is the volume where the OS is installed.

另请参阅

root()

PySide2.QtCore.QStorageInfo. isValid ( ) ¶

返回类型

bool

返回 true 若 QStorageInfo 指定通过 rootPath exists and is mounted correctly.

另请参阅

isReady()

static PySide2.QtCore.QStorageInfo. mountedVolumes ( ) ¶

返回类型

Returns the list of QStorageInfo objects that corresponds to the list of currently mounted filesystems.

On Windows, this returns the drives visible in the My Computer folder. On Unix operating systems, it returns the list of all mounted filesystems (except for pseudo filesystems).

Returns all currently mounted filesystems by default.

The example shows how to retrieve all available filesystems, skipping read-only ones.

foreach (const QStorageInfo &storage, QStorageInfo::mountedVolumes()) {
    if (storage.isValid() && storage.isReady()) {
        if (!storage.isReadOnly()) {
            // ...
        }
    }
}
											

另请参阅

root()

PySide2.QtCore.QStorageInfo. name ( ) ¶

返回类型

unicode

Returns the human-readable name of a filesystem, usually called label .

Not all filesystems support this feature. In this case, the value returned by this method could be empty. An empty string is returned if the file system does not support labels, or if no label is set.

On Linux, retrieving the volume’s label requires udev to be present in the system.

另请参阅

fileSystemType()

PySide2.QtCore.QStorageInfo. __ne__ ( second ) ¶

参数

second – QStorageInfo

返回类型

bool

PySide2.QtCore.QStorageInfo. __eq__ ( second ) ¶

参数

second – QStorageInfo

返回类型

bool

PySide2.QtCore.QStorageInfo. refresh ( ) ¶

Resets QStorageInfo ‘s internal cache.

QStorageInfo caches information about storage to speed up performance. QStorageInfo retrieves information during object construction and/or when calling the setPath() method. You have to manually reset the cache by calling this function to update storage information.

static PySide2.QtCore.QStorageInfo. root ( ) ¶

返回类型

QStorageInfo

返回 QStorageInfo object that represents the system root volume.

On Unix systems this call returns the root (‘/’) volume; in Windows the volume where the operating system is installed.

另请参阅

isRoot()

PySide2.QtCore.QStorageInfo. rootPath ( ) ¶

返回类型

unicode

Returns the mount point of the filesystem this QStorageInfo object represents.

On Windows, it returns the volume letter in case the volume is not mounted to a directory.

Note that the value returned by is the real mount point of a volume, and may not be equal to the value passed to the constructor or setPath() method. For example, if you have only the root volume in the system, and pass ‘/directory’ to setPath() , then this method will return ‘/’.

另请参阅

setPath() device()

PySide2.QtCore.QStorageInfo. setPath ( path ) ¶

参数

path – unicode

设置此 QStorageInfo object to the filesystem mounted where path is located.

path can either be a root path of the filesystem, a directory, or a file within that filesystem.

另请参阅

rootPath()

PySide2.QtCore.QStorageInfo. subvolume ( ) ¶

返回类型

QByteArray

Returns the subvolume name for this volume.

Some filesystem types allow multiple subvolumes inside one device, which may be mounted in different paths. If the subvolume could be detected, it is returned here. The format of the subvolume name is specific to each filesystem type.

If this volume was not mounted from a subvolume of a larger filesystem or if the subvolume could not be detected, this function returns an empty byte array.

另请参阅

device()

PySide2.QtCore.QStorageInfo. swap ( other ) ¶

参数

other – QStorageInfo

Swaps this volume info with other 。此函数非常快，且从不失败。