En esta página

QStorageInfo Class

Ofrece información sobre los dispositivos de almacenamiento y las unidades montadas actualmente. Más...

Encabezado: #include <QStorageInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Comparaciones de QStorageInfo

CategoríaTipos comparables
igualdadQStorageInfo

Funciones públicas

QStorageInfo()
QStorageInfo(const QDir &dir)
QStorageInfo(const QString &path)
QStorageInfo(const QStorageInfo &other)
(since 6.10) QStorageInfo(QStorageInfo &&other)
~QStorageInfo()
int blockSize() const
qint64 bytesAvailable() const
qint64 bytesFree() const
qint64 bytesTotal() const
QByteArray device() const
QString displayName() const
QByteArray fileSystemType() const
bool isReadOnly() const
bool isReady() const
bool isRoot() const
bool isValid() const
QString name() const
void refresh()
QString rootPath() const
void setPath(const QString &path)
QByteArray subvolume() const
void swap(QStorageInfo &other)
QStorageInfo &operator=(QStorageInfo &&other)
QStorageInfo &operator=(const QStorageInfo &other)

Miembros públicos estáticos

QList<QStorageInfo> mountedVolumes()
QStorageInfo root()
bool operator!=(const QStorageInfo &lhs, const QStorageInfo &rhs)
bool operator==(const QStorageInfo &lhs, const QStorageInfo &rhs)

Descripción detallada

Permite obtener información sobre el espacio disponible en el volumen, su punto de montaje, su etiqueta y el nombre del sistema de archivos.

Se puede crear una instancia de QStorageInfo pasando la ruta al punto de montaje del volumen como parámetro del constructor, o bien se puede establecer mediante el método setPath(). El método estático mountedVolumes() se puede utilizar para obtener la lista de todos los sistemas de archivos montados.

QStorageInfo siempre almacena en caché la información recuperada, pero se puede llamar a refresh() para invalidar la caché.

El siguiente ejemplo recupera la información más habitual sobre el volumen raíz del sistema y muestra dicha información.

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";

Documentación sobre funciones de miembro

QStorageInfo::QStorageInfo()

Crea un objeto QStorageInfo vacío.

Los objetos creados con el constructor por defecto no serán válidos y, por lo tanto, no estarán listos para su uso.

Véase también setPath(), isReady() y isValid().

[explicit] QStorageInfo::QStorageInfo(const QDir &dir)

Crea un nuevo objeto `QStorageInfo` que proporciona información sobre el volumen que contiene la carpeta « dir ».

[explicit] QStorageInfo::QStorageInfo(const QString &path)

Crea un nuevo objeto QStorageInfo que proporciona información sobre el volumen montado en path.

Si se pasa un directorio o un archivo, el objeto QStorageInfo hará referencia al volumen en el que se encuentra dicho directorio o archivo. Se puede comprobar si el objeto creado es correcto utilizando el método isValid().

El siguiente ejemplo muestra cómo obtener el volumen en el que se encuentra la aplicación. Se recomienda comprobar siempre que el volumen esté listo y sea válido.

QStorageInfo storage(qApp->applicationDirPath());
if (storage.isValid() && storage.isReady()) {
    // ...
}

Véase también setPath().

QStorageInfo::QStorageInfo(const QStorageInfo &other)

Crea un nuevo objeto `QStorageInfo` que es una copia del objeto `QStorageInfo` de ` other `.

[constexpr noexcept default, since 6.10] QStorageInfo::QStorageInfo(QStorageInfo &&other)

Crea un nuevo objeto `QStorageInfo` a partir de ` other`.

El objeto del que se ha realizado el movimiento, ` other `, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.10.

[noexcept] QStorageInfo::~QStorageInfo()

Destruye el objeto ` QStorageInfo ` y libera sus recursos.

int QStorageInfo::blockSize() const

Devuelve el tamaño óptimo de bloque de transferencia para este sistema de archivos.

Devuelve -1 si QStorageInfo no ha podido determinar el tamaño o si el objeto QStorageInfo no es válido.

qint64 QStorageInfo::bytesAvailable() const

Devuelve el espacio disponible (en bytes) para el usuario actual. Devuelve el espacio total disponible si el usuario es el usuario «root» o un administrador del sistema.

Este tamaño puede ser menor o igual que el tamaño libre devuelto por la función ` bytesFree()`.

Devuelve -1 si el objeto ` QStorageInfo ` no es válido.

Véanse también ` bytesTotal()` y ` bytesFree()`.

qint64 QStorageInfo::bytesFree() const

Devuelve el número de bytes libres en un volumen. Ten en cuenta que, si hay cuotas en el sistema de archivos, este valor puede ser mayor que el valor devuelto por la función ` bytesAvailable()`.

Devuelve -1 si el objeto ` QStorageInfo ` no es válido.

Véanse también bytesTotal() y bytesAvailable().

qint64 QStorageInfo::bytesTotal() const

Devuelve el tamaño total del volumen en bytes.

Devuelve -1 si el objeto ` QStorageInfo ` no es válido.

Véase también bytesFree() y bytesAvailable().

QByteArray QStorageInfo::device() const

Devuelve el dispositivo correspondiente a este volumen.

Por ejemplo, en sistemas de archivos Unix (incluido macOS), devuelve la ruta de dispositivo del tipo /dev/sda0 para los almacenamientos locales. En Windows, devuelve la ruta UNC que comienza por \\\\?\\ para los almacenamientos locales (en otras palabras, el GUID del volumen).

Véase también rootPath() y subvolume().

QString QStorageInfo::displayName() const

Devuelve el nombre del volumen, si está disponible, o la ruta raíz en caso contrario.

QByteArray QStorageInfo::fileSystemType() const

Devuelve el nombre del tipo del sistema de archivos.

Se trata de una función dependiente de la plataforma, y los nombres de los sistemas de archivos pueden variar entre los distintos sistemas operativos. Por ejemplo, en los sistemas de archivos de Windows pueden llamarse NTFS, y en Linux pueden llamarse ntfs-3g o fuseblk.

Véase también name().

bool QStorageInfo::isReadOnly() const

Devuelve «true» si el sistema de archivos actual está protegido contra la escritura; en caso contrario, devuelve «false».

bool QStorageInfo::isReady() const

Devuelve «true» si el sistema de archivos actual está listo para funcionar; en caso contrario, devuelve «false». Por ejemplo, se devuelve «false» si no se ha insertado el CD.

Ten en cuenta que fileSystemType(), name(), bytesTotal(), bytesFree() y bytesAvailable() devolverán datos no válidos hasta que el volumen esté listo.

Véase también isValid().

bool QStorageInfo::isRoot() const

Devuelve «true» si este « QStorageInfo » representa el volumen raíz del sistema; en caso contrario, devuelve «false».

En los sistemas de archivos Unix, el volumen raíz es un volumen montado en /. En Windows, el volumen raíz es aquel en el que está instalado el sistema operativo.

Véase también root().

bool QStorageInfo::isValid() const

Devuelve «true» si el dispositivo « QStorageInfo » especificado por « rootPath » existe y está montado correctamente.

Véase también isReady().

[static] QList<QStorageInfo> QStorageInfo::mountedVolumes()

Devuelve la lista de objetos ` QStorageInfo ` que se corresponde con la lista de sistemas de archivos montados actualmente.

En Windows, devuelve las unidades visibles en la carpeta «Mi PC ». En los sistemas operativos Unix, devuelve la lista de todos los sistemas de archivos montados (excepto los pseudo-sistemas de archivos).

Por defecto, devuelve todos los sistemas de archivos montados actualmente.

El ejemplo muestra cómo recuperar todos los sistemas de archivos disponibles, omitiendo los de solo lectura.

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

Véase también root().

QString QStorageInfo::name() const

Devuelve el nombre legible para el usuario de un sistema de archivos, normalmente denominado « label ».

No todos los sistemas de archivos admiten esta característica. En tal caso, el valor devuelto por este método podría estar vacío. Se devuelve una cadena vacía si el sistema de archivos no admite etiquetas o si no se ha establecido ninguna.

En Linux, para obtener la etiqueta del volumen es necesario que el sistema cuente c udev.

Véase también fileSystemType().

void QStorageInfo::refresh()

Restablece la caché interna de QStorageInfo.

QStorageInfo Almacena en caché información sobre el almacenamiento para acelerar el rendimiento. QStorageInfo recupera información durante la construcción de objetos y/o al llamar al método setPath(). Debes restablecer manualmente la caché llamando a esta función para actualizar la información de almacenamiento.

[static] QStorageInfo QStorageInfo::root()

Devuelve un objeto ` QStorageInfo ` que representa el volumen raíz del sistema.

En sistemas Unix, esta llamada devuelve el volumen raíz («/»); en Windows, el volumen en el que está instalado el sistema operativo.

Véase también isRoot().

QString QStorageInfo::rootPath() const

Devuelve el punto de montaje del sistema de archivos que representa este objeto ` QStorageInfo `.

En Windows, devuelve la letra del volumen en caso de que este no esté montado en un directorio.

Ten en cuenta que el valor devuelto por rootPath() es el punto de montaje real de un volumen y puede no ser igual al valor pasado al constructor o al método setPath(). Por ejemplo, si solo tienes el volumen raíz en el sistema y pasas «/directory» a setPath(), este método devolverá «/».

Véase también setPath() y device().

void QStorageInfo::setPath(const QString &path)

Establece este objeto ` QStorageInfo ` en el sistema de archivos montado donde se encuentra ` path `.

path Puede ser una ruta raíz del sistema de archivos, un directorio o un archivo dentro de dicho sistema de archivos.

Véase también rootPath().

QByteArray QStorageInfo::subvolume() const

Devuelve el nombre del subvolumen de este volumen.

Algunos tipos de sistemas de archivos permiten tener varios subvolúmenes dentro de un mismo dispositivo, que pueden montarse en diferentes rutas (por ejemplo, montajes «bind» en Unix o subvolúmenes del sistema de archivos Btrfs). Si se ha podido detectar el subvolumen, esta función devuelve su nombre. El formato del nombre del subvolumen es específico de cada tipo de sistema de archivos.

Si este volumen no se ha montado a partir de un subvolumen de un sistema de archivos más grande o si no se ha podido detectar el subvolumen, esta función devuelve una matriz de bytes vacía.

Véase también device().

[noexcept] void QStorageInfo::swap(QStorageInfo &other)

Intercambia esta información sobre el volumen con other. Esta operación es muy rápida y nunca falla.

[noexcept] QStorageInfo &QStorageInfo::operator=(QStorageInfo &&other)

La operación «Move-assigns» asigna other a esta instancia de QStorageInfo.

El objeto del que se ha realizado la asignación, other, pasa a un estado válido, pero no especificado.

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

Crea una copia del objeto « QStorageInfo » other y la asigna a este objeto « QStorageInfo ».

Elementos no miembros relacionados

[noexcept] bool operator!=(const QStorageInfo &lhs, const QStorageInfo &rhs)

Devuelve « true » si el objeto « QStorageInfo » lhs hace referencia a una unidad o volumen distinto del objeto « QStorageInfo » rhs; en caso contrario, devuelve « false ».

[noexcept] bool operator==(const QStorageInfo &lhs, const QStorageInfo &rhs)

Devuelve ` true ` si el objeto ` QStorageInfo ` lhs hace referencia a la misma unidad o volumen que el objeto ` QStorageInfo ` rhs; en caso contrario, devuelve ` false`.

Tenga en cuenta que el resultado de comparar dos objetos QStorageInfo no válidos es siempre positivo.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.