En esta página

QFileInfo Class

La clase QFileInfo proporciona una API independiente del sistema operativo para obtener información sobre las entradas del sistema de archivos. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QFileInfo

CategoríaTipos comparables
igualdadQFileInfo

Funciones públicas

QFileInfo()
QFileInfo(const QFileDevice &file)
QFileInfo(const QString &path)
(since 6.0) QFileInfo(const std::filesystem::path &file)
QFileInfo(const QDir &dir, const QString &path)
(since 6.0) QFileInfo(const QDir &dir, const std::filesystem::path &path)
QFileInfo(const QFileInfo &fileinfo)
(since 6.12) QFileInfo(QFileInfo &&other)
~QFileInfo()
QDir absoluteDir() const
QString absoluteFilePath() const
QString absolutePath() const
QString baseName() const
QDateTime birthTime() const
(since 6.6) QDateTime birthTime(const QTimeZone &tz) const
QString bundleName() const
bool caching() const
QString canonicalFilePath() const
QString canonicalPath() const
QString completeBaseName() const
QString completeSuffix() const
QDir dir() const
bool exists() const
QString fileName() const
QString filePath() const
QDateTime fileTime(QFileDevice::FileTime time) const
(since 6.6) QDateTime fileTime(QFileDevice::FileTime time, const QTimeZone &tz) const
(since 6.0) std::filesystem::path filesystemAbsoluteFilePath() const
(since 6.0) std::filesystem::path filesystemAbsolutePath() const
(since 6.0) std::filesystem::path filesystemCanonicalFilePath() const
(since 6.0) std::filesystem::path filesystemCanonicalPath() const
(since 6.0) std::filesystem::path filesystemFilePath() const
(since 6.2) std::filesystem::path filesystemJunctionTarget() const
(since 6.0) std::filesystem::path filesystemPath() const
(since 6.6) std::filesystem::path filesystemReadSymLink() const
(since 6.0) std::filesystem::path filesystemSymLinkTarget() const
QString group() const
uint groupId() const
bool isAbsolute() const
(since 6.4) bool isAlias() const
bool isBundle() const
bool isDir() const
bool isExecutable() const
bool isFile() const
bool isHidden() const
bool isJunction() const
bool isNativePath() const
(since 6.10) bool isOther() const
bool isReadable() const
bool isRelative() const
bool isRoot() const
bool isShortcut() const
bool isSymLink() const
bool isSymbolicLink() const
bool isWritable() const
(since 6.2) QString junctionTarget() const
QDateTime lastModified() const
(since 6.6) QDateTime lastModified(const QTimeZone &tz) const
QDateTime lastRead() const
(since 6.6) QDateTime lastRead(const QTimeZone &tz) const
bool makeAbsolute()
QDateTime metadataChangeTime() const
(since 6.6) QDateTime metadataChangeTime(const QTimeZone &tz) const
QString owner() const
uint ownerId() const
QString path() const
bool permission(QFileDevice::Permissions permissions) const
QFileDevice::Permissions permissions() const
(since 6.6) QString readSymLink() const
void refresh()
void setCaching(bool enable)
void setFile(const QString &path)
(since 6.0) void setFile(const std::filesystem::path &path)
void setFile(const QFileDevice &file)
void setFile(const QDir &dir, const QString &path)
qint64 size() const
(since 6.0) void stat()
QString suffix() const
void swap(QFileInfo &other)
QString symLinkTarget() const
QFileInfo &operator=(QFileInfo &&other)
QFileInfo &operator=(const QFileInfo &fileinfo)

Miembros públicos estáticos

bool exists(const QString &path)
QFileInfoList
bool operator!=(const QFileInfo &lhs, const QFileInfo &rhs)
bool operator==(const QFileInfo &lhs, const QFileInfo &rhs)

Macros

Descripción detallada

QFileInfo proporciona información sobre una entrada del sistema de archivos, como su nombre, ruta, derechos de acceso y si se trata de un archivo normal, un directorio o un enlace simbólico. También se puede consultar el tamaño de la entrada y las fechas de última modificación y lectura. QFileInfo también se puede utilizar para obtener información sobre un recurso de Qt.

Un objeto QFileInfo puede apuntar a una entrada del sistema de archivos mediante una ruta absoluta o relativa:

  • En Unix, las rutas absolutas comienzan con el separador de directorios '/'. En Windows, las rutas absolutas comienzan con la especificación de la unidad (por ejemplo, D:/).
  • Las rutas relativas comienzan con un nombre de directorio o un nombre de archivo normal y especifican la ruta de una entrada del sistema de archivos relativa al directorio de trabajo actual.

Un ejemplo de ruta absoluta es la cadena "/tmp/quartz". Una ruta relativa puede tener el siguiente aspecto: "src/fatlib". Puedes utilizar la función isRelative() para comprobar si un objeto QFileInfo utiliza una ruta relativa o absoluta. Puedes llamar a la función makeAbsolute() para convertir la ruta relativa de un objeto QFileInfo en una ruta absoluta.

Nota: Las rutas que comienzan con dos puntos (:) siempre se consideran absolutas, ya que indican un QResource.

La ruta de la entrada del sistema de archivos con la que trabaja el objeto `QFileInfo` se establece en el constructor o posteriormente mediante ` setFile()`. Utiliza ` exists()` para comprobar si la entrada existe realmente y ` size()` para obtener su tamaño.

El tipo de la entrada del sistema de archivos se obtiene mediante isFile(), isDir() y isSymLink(). La función symLinkTarget() proporciona la ruta absoluta del destino al que apunta el enlace simbólico.

Los elementos de la ruta de la entrada del sistema de archivos se pueden extraer con path() y fileName(). Las partes de fileName() se pueden extraer con baseName(), suffix() o completeSuffix(). Los objetos `QFileInfo` que hacen referencia a directorios creados por clases de Qt no tendrán un separador de directorio al final ` '/'`. Si deseas utilizar separadores finales en tus propios objetos de información de archivos, solo tienes que añadir uno a la ruta de la entrada proporcionada a los constructores o a ` setFile()`.

La información relacionada con la fecha y la hora se obtiene mediante birthTime(), fileTime(), lastModified(), lastRead() y metadataChangeTime(). La información sobre los permisos de acceso se puede obtener con isReadable(), isWritable() y isExecutable(). La información sobre la propiedad se puede obtener mediante owner(), ownerId(), group() y groupId(). También puede examinar los permisos y la propiedad en una sola instrucción utilizando la función permission().

En Unix (incluidos macOS e iOS), las funciones de obtención de propiedades de esta clase devuelven propiedades como las fechas y el tamaño del destino, no del enlace simbólico, ya que Unix gestiona los enlaces simbólicos de forma transparente. Al abrir un enlace simbólico mediante ` QFile `, se abre efectivamente el destino del enlace. Por ejemplo:

#ifdef Q_OS_UNIX

QFileInfo info1("/home/bob/bin/untabify");
info1.isSymLink();          // returns true
info1.absoluteFilePath();   // returns "/home/bob/bin/untabify"
info1.size();               // returns 56201
info1.symLinkTarget();      // returns "/opt/pretty++/bin/untabify"

QFileInfo info2(info1.symLinkTarget());
info2.isSymLink();          // returns false
info2.absoluteFilePath();   // returns "/opt/pretty++/bin/untabify"
info2.size();               // returns 56201

#endif

En Windows, los accesos directos (archivos «.lnk ») se tratan actualmente como enlaces simbólicos. Al igual que en los sistemas Unix, los métodos de obtención de propiedades devuelven el tamaño del destino, no el propio archivo « .lnk ». Este comportamiento está obsoleto y es probable que se elimine en una futura versión de Qt, tras lo cual los archivos « .lnk » se tratarán como archivos normales.

#ifdef Q_OS_WIN

QFileInfo info1("C:\\Users\\Bob\\untabify.lnk");
info1.isSymLink();          // returns true
info1.absoluteFilePath();   // returns "C:/Users/Bob/untabify.lnk"
info1.size();               // returns 63942
info1.symLinkTarget();      // returns "C:/Pretty++/untabify"

QFileInfo info2(info1.symLinkTarget());
info2.isSymLink();          // returns false
info2.absoluteFilePath();   // returns "C:/Pretty++/untabify"
info2.size();               // returns 63942

#endif

Permisos NTFS

En los sistemas de archivos NTFS, la comprobación de la propiedad y los permisos está desactivada por defecto por motivos de rendimiento. Para activarla, incluye la siguiente línea:

extern Q_CORE_EXPORT int qt_ntfs_permission_lookup;

La comprobación de permisos se activa y desactiva incrementando o decrementando el valor de « qt_ntfs_permission_lookup » en 1.

qt_ntfs_permission_lookup++; // turn checking on
qt_ntfs_permission_lookup--; // turn it off again

Nota: Dado que se trata de una variable global no atómica, solo es seguro incrementar o decrementar ` qt_ntfs_permission_lookup ` antes de que se haya iniciado ningún hilo que no sea el hilo principal o después de que todos los hilos, excepto el hilo principal, hayan finalizado.

Nota: A partir de Qt 6.6, la variable qt_ntfs_permission_lookup ha quedado obsoleta. Utiliza las siguientes alternativas.

La forma más segura y sencilla de gestionar las comprobaciones de permisos es utilizar la clase RAII QNtfsPermissionCheckGuard.

void complexFunction()
{
    QNtfsPermissionCheckGuard permissionGuard;  // check is enabled

    // do complex things here that need permission check enabled

}   // as the guard goes out of scope the check is disabled

Si necesitas un control más preciso, también puedes gestionar los permisos mediante las siguientes funciones:

qAreNtfsPermissionChecksEnabled();   // comprobar el estado
qEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

Consideraciones sobre el rendimiento

Algunas de las funciones de QFileInfo tienen que consultar el sistema de archivos, pero por motivos de rendimiento, otras solo operan sobre la cadena de ruta. Por ejemplo: para devolver la ruta absoluta de una entrada relativa, la función ` absolutePath()` tiene que consultar el sistema de archivos. La función ` path()`, sin embargo, puede trabajar directamente con el nombre del archivo, por lo que es más rápida.

QFileInfo también almacena en caché información sobre la entrada del sistema de archivos a la que hace referencia. Dado que el sistema de archivos puede ser modificado por otros usuarios o programas, o incluso por otras partes del mismo programa, existe una función que actualiza la información almacenada en QFileInfo, concretamente refresh(). Para desactivar el almacenamiento en caché de un QFileInfo (es decir, obligarlo a consultar el sistema de archivos subyacente cada vez que se le solicite información), llama a setCaching(false).

La obtención de información del sistema de archivos suele realizarse mediante la llamada a funciones del sistema que pueden resultar costosas, por lo que es posible que QFileInfo (dependiendo de la implementación) no recupere toda la información del sistema de archivos en el momento de su creación. Para asegurarte de que toda la información se lee del sistema de archivos de forma inmediata, utiliza la función miembro stat().

birthTime(), fileTime(), lastModified(), lastRead() y metadataChangeTime() devuelven las horas en hora local por defecto. Dado que la API nativa del sistema de archivos suele utilizar UTC, esto requiere una conversión. Si realmente no necesitas la hora local, puedes evitarlo solicitando la hora directamente en QTimeZone::UTC.

Cuestiones específicas de cada plataforma

En Android, existen algunas limitaciones a la hora de gestionar las URI de contenido:

Véase también QDir y QFile.

Documentación de las funciones miembro

QFileInfo::QFileInfo()

Crea un objeto QFileInfo vacío que no hace referencia a ninguna entrada del sistema de archivos.

Véase también setFile().

[explicit] QFileInfo::QFileInfo(const QFileDevice &file)

Crea un nuevo objeto `QFileInfo` que proporciona información sobre el archivo ` file`.

Si el ` file ` tiene una ruta relativa, el `QFileInfo` también tendrá una ruta relativa.

Véase también isRelative().

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

Crea un objeto `QFileInfo` que proporciona información sobre una entrada del sistema de archivos situada en ` path `, que puede ser absoluta o relativa.

Si path es relativa, el objeto QFileInfo también tendrá una ruta relativa.

Véase también setFile(), isRelative(), QDir::setCurrent() y QDir::isRelativePath().

[since 6.0] QFileInfo::QFileInfo(const std::filesystem::path &file)

Crea un nuevo objeto `QFileInfo` que proporciona información sobre el archivo ` file` indicado.

Esta función se introdujo en Qt 6.0.

Véase también setFile(), isRelative(), QDir::setCurrent() y QDir::isRelativePath().

[explicit] QFileInfo::QFileInfo(const QDir &dir, const QString &path)

Crea un nuevo objeto `QFileInfo` que proporciona información sobre la entrada del sistema de archivos especificada ` path `, relativa al directorio ` dir`.

Si dir tiene una ruta relativa, el objeto QFileInfo también tendrá una ruta relativa.

Si ` path ` es absoluta, se ignorará el directorio especificado por ` dir `.

Véase también isRelative().

[since 6.0] QFileInfo::QFileInfo(const QDir &dir, const std::filesystem::path &path)

Crea un nuevo objeto `QFileInfo` que proporciona información sobre la entrada del sistema de archivos situada en ` path `, relativa al directorio ` dir`.

Si dir tiene una ruta relativa, el QFileInfo también tendrá una ruta relativa.

Si path es absoluta, se ignorará el directorio especificado por dir.

Esta función se introdujo en Qt 6.0.

QFileInfo::QFileInfo(const QFileInfo &fileinfo)

Crea un nuevo objeto `QFileInfo` que es una copia del objeto ` fileinfo` especificado.

[constexpr noexcept default, since 6.12] QFileInfo::QFileInfo(QFileInfo &&other)

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

Nota: El objeto del que se ha realizado el traslado, other, queda en 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.12.

[noexcept] QFileInfo::~QFileInfo()

Elimina el objeto « QFileInfo » y libera sus recursos.

QDir QFileInfo::absoluteDir() const

Devuelve un objeto ` QDir ` que representa la ruta absoluta del directorio principal de la entrada del sistema de archivos a la que hace referencia este ` QFileInfo `.

// Suponiendo que el directorio de trabajo actual es «/home/user/Documents/memos/»
QFileInfo info1(u"relativeFile"_s);
qDebug() << info1.absolutePath(); // "/home/user/Documents/memos/"
qDebug() << info1.baseName(); // "relativeFile"
qDebug() << info1.absoluteDir(); // QDir(u"/home/user/Documents/memos"_s)
qDebug() << info1.absoluteDir().path(); // "/home/user/Documents/memos"

// Un objeto QFileInfo de un directorio
QFileInfo info2(u"/home/user/Documents/memos"_s);
qDebug() << info2.absolutePath(); // "/home/user/Documents"
qDebug() << info2.baseName(); // "memos"
qDebug() << info2.absoluteDir(); // QDir(u"/home/user/Documents"_s)
qDebug() << info2.absoluteDir().path(); // "/home/user/Documents"

Véase también dir(), filePath(), fileName() y isRelative().

QString QFileInfo::absoluteFilePath() const

Devuelve la ruta completa absoluta a la entrada del sistema de archivos a la que hace referencia este ` QFileInfo `, incluido el nombre de la entrada.

En Unix, las rutas absolutas comienzan con el separador de directorios '/'. En Windows, las rutas absolutas comienzan con la especificación de la unidad (por ejemplo, D:/).

En Windows, las rutas de los recursos compartidos de red que no están asignados a una letra de unidad comienzan por //sharename/.

QFileInfo convierte las letras de unidad a mayúsculas. Ten en cuenta que QDir no hace esto. El fragmento de código siguiente lo muestra.

    QFileInfo fi("c:/temp/foo");
    qDebug() << fi.absoluteFilePath(); // "C:/temp/foo"

Esta función devuelve el mismo resultado que ` filePath()`, salvo que ` isRelative()` sea verdadero. A diferencia de ` canonicalFilePath()`, los enlaces simbólicos o los elementos redundantes «.» o «..» no se eliminan necesariamente.

Advertencia: Si filePath() está vacío, el comportamiento de esta función es indefinido.

Véase también filePath(), canonicalFilePath() y isRelative().

QString QFileInfo::absolutePath() const

Devuelve la ruta absoluta de la entrada del sistema de archivos a la que hace referencia este QFileInfo, excluyendo el nombre de la entrada.

En Unix, las rutas absolutas comienzan con el separador de directorios '/'. En Windows, las rutas absolutas comienzan con una especificación de unidad (por ejemplo, D:/).

En Windows, las rutas de los recursos compartidos de red que no están asignados a una letra de unidad comienzan con //sharename/.

A diferencia de canonicalPath(), los enlaces simbólicos o los elementos redundantes «.» o «..» no se eliminan necesariamente.

Advertencia: Si filePath() está vacío, el comportamiento de esta función es indefinido.

Véase también absoluteFilePath(), path(), canonicalPath(), fileName() y isRelative().

QString QFileInfo::baseName() const

Devuelve el nombre base del archivo sin la ruta.

El nombre base está formado por todos los caracteres del nombre del archivo hasta el primer carácter «.» (sin incluirlo).

Ejemplo:

QFileInfo fi("/tmp/archive.tar.gz");
QString base = fi.baseName();  // base = "archive"

El nombre base de un archivo se calcula de la misma forma en todas las plataformas, independientemente de las convenciones de nomenclatura de archivos (por ejemplo, «.bashrc» en Unix tiene un nombre base vacío y el sufijo es «bashrc»).

Véase también fileName(), suffix(), completeSuffix() y completeBaseName().

QDateTime QFileInfo::birthTime() const

Devuelve la fecha y la hora en que se creó el archivo, en hora local.

Si no se dispone de la hora de creación del archivo, esta función devuelve un valor no válido « QDateTime ».

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función sobrecarga QFileInfo::birthTime(const QTimeZone &tz) y devuelve lo mismo que birthTime(QTimeZone::LocalTime).

Véase también lastModified(), lastRead(), metadataChangeTime() y fileTime().

[since 6.6] QDateTime QFileInfo::birthTime(const QTimeZone &tz) const

Devuelve la fecha y la hora en que se creó el archivo.

La hora devuelta se expresa en la zona horaria especificada por tz. Por ejemplo, puedes utilizar QTimeZone::LocalTime o QTimeZone::UTC para obtener la hora en la zona horaria local o en UTC, respectivamente. Dado que la API nativa del sistema de archivos suele utilizar UTC, el uso de QTimeZone::UTC suele ser más rápido, ya que no requiere ninguna conversión.

Si no se dispone de la hora de creación del archivo, esta función devuelve un valor no válido QDateTime.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función se introdujo en Qt 6.6.

Véase también lastModified(const QTimeZone &), lastRead(const QTimeZone &), metadataChangeTime(const QTimeZone &) y fileTime(QFileDevice::FileTime, const QTimeZone &).

QString QFileInfo::bundleName() const

Devuelve el nombre del paquete.

En macOS e iOS, devuelve el nombre localizado adecuado de un paquete si la ruta es isBundle(). En el resto de plataformas, se devuelve un QString vacío.

Ejemplo:

QFileInfo fi("/Applications/Safari.app");
QString bundle = fi.bundleName();                // name = "Safari"

Véase también isBundle(), filePath(), baseName() y suffix().

bool QFileInfo::caching() const

Devuelve « true » si el almacenamiento en caché está activado; en caso contrario, devuelve « false ».

Véase también setCaching() y refresh().

QString QFileInfo::canonicalFilePath() const

Devuelve la ruta canónica de la entrada del sistema de archivos, incluyendo el nombre de la entrada; es decir, una ruta absoluta sin enlaces simbólicos ni elementos redundantes del tipo '.' o '..'.

Este método devuelve una cadena vacía si la entrada no existe, no es accesible (por ejemplo, si el usuario actual no tiene acceso a una ruta de directorio) o si se produce un error al canonizar la ruta (normalmente debido a enlaces simbólicos sueltos).

Véanse también filePath(), absoluteFilePath() y dir().

QString QFileInfo::canonicalPath() const

Devuelve la ruta canónica de la entrada del sistema de archivos (sin incluir el nombre de la entrada), es decir, una ruta absoluta sin enlaces simbólicos ni elementos redundantes como «.» o «..».

Este método devuelve una cadena vacía si la entrada no existe, no es accesible (por ejemplo, si el usuario actual no tiene acceso a una ruta de directorio) o si se produce un error al canonizar la ruta (normalmente debido a enlaces simbólicos colgantes).

Véase también path() y absolutePath().

QString QFileInfo::completeBaseName() const

Devuelve el nombre base completo del archivo sin la ruta.

El nombre base completo está formado por todos los caracteres del nombre del archivo hasta el último carácter «.» (sin incluirlo).

Ejemplo:

QFileInfo fi("/tmp/archive.tar.gz");
QString base = fi.completeBaseName();  // base = "archive.tar"

Véase también fileName(), suffix(), completeSuffix() y baseName().

QString QFileInfo::completeSuffix() const

Devuelve el sufijo completo (extensión) del archivo.

El sufijo completo está formado por todos los caracteres del nombre del archivo que aparecen después del primer «.» (sin incluirlo).

Ejemplo:

QFileInfo fi("/tmp/archive.tar.gz");
QString ext = fi.completeSuffix();  // ext = "tar.gz"

Véase también fileName(), suffix(), baseName() y completeBaseName().

QDir QFileInfo::dir() const

Devuelve un objeto ` QDir ` que representa la ruta del directorio principal de la entrada del sistema de archivos a la que hace referencia este ` QFileInfo `.

Nota: El objeto ` QDir ` devuelto siempre corresponde al directorio padre del objeto, incluso si el ` QFileInfo ` representa un directorio.

En cada uno de los siguientes casos, dir() devuelve el QDir "~/examples/191697" .

    QFileInfo fileInfo1("~/examples/191697/.");
    QFileInfo fileInfo2("~/examples/191697/..");
    QFileInfo fileInfo3("~/examples/191697/main.cpp");

Para cada uno de los siguientes casos, dir() devuelve el QDir "." .

    QFileInfo fileInfo4(".");
    QFileInfo fileInfo5("..");
    QFileInfo fileInfo6("main.cpp");

Véase también absolutePath(), filePath(), fileName(), isRelative() y absoluteDir().

bool QFileInfo::exists() const

Devuelve « true » si existe la entrada del sistema de archivos a la que hace referencia « QFileInfo »; en caso contrario, devuelve « false ».

Nota: Si la entrada es un enlace simbólico que apunta a un destino inexistente, este método devuelve false.

[static] bool QFileInfo::exists(const QString &path)

Devuelve true si existe la entrada del sistema de archivos path; en caso contrario, devuelve false.

Nota: Si path es un enlace simbólico que apunta a un destino inexistente, este método devuelve false.

Nota: El uso de esta función es más rápido que utilizar QFileInfo(path).exists() para acceder al sistema de archivos.

QString QFileInfo::fileName() const

Devuelve el nombre de la entrada del sistema de archivos a la que hace referencia este ` QFileInfo `, sin incluir la ruta.

Ejemplo:

QFileInfo fi("/tmp/archive.tar.gz");
QString name = fi.fileName();                // name = "archive.tar.gz"

Nota: Si a este ` QFileInfo ` se le proporciona una ruta que termina con un separador de directorios ` '/'`, la parte del nombre de la entrada se considera vacía.

Véase también isRelative(), filePath(), baseName() y suffix().

QString QFileInfo::filePath() const

Devuelve la ruta de la entrada del sistema de archivos a la que hace referencia este QFileInfo; la ruta puede ser absoluta o relativa.

Véase también absoluteFilePath(), canonicalFilePath() y isRelative().

QDateTime QFileInfo::fileTime(QFileDevice::FileTime time) const

Devuelve la hora del archivo especificada por ` time`.

Si no se puede determinar la hora, se devuelve una fecha y hora no válida.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función sobrecarga QFileInfo::fileTime(QFileDevice::FileTime, const QTimeZone &) y devuelve lo mismo que fileTime(time, QTimeZone::LocalTime).

Véase también birthTime(), lastModified(), lastRead() y metadataChangeTime().

[since 6.6] QDateTime QFileInfo::fileTime(QFileDevice::FileTime time, const QTimeZone &tz) const

Devuelve la fecha y hora del archivo especificadas por time.

La hora devuelta está en la zona horaria especificada por ` tz`. Por ejemplo, puedes utilizar ` QTimeZone::LocalTime ` o ` QTimeZone::UTC ` para obtener la hora en la zona horaria local o en UTC, respectivamente. Dado que la API nativa del sistema de archivos suele utilizar UTC, el uso de ` QTimeZone::UTC ` suele ser más rápido, ya que no requiere ninguna conversión.

Si no se puede determinar la hora, se devuelve una fecha y hora no válidas.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función se introdujo en Qt 6.6.

Véase también birthTime(const QTimeZone &), lastModified(const QTimeZone &), lastRead(const QTimeZone &), metadataChangeTime(const QTimeZone &) y QDateTime::isValid().

[since 6.0] std::filesystem::path QFileInfo::filesystemAbsoluteFilePath() const

Devuelve ` absoluteFilePath()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.0.

Véase también ` absoluteFilePath()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemAbsolutePath() const

Devuelve ` absolutePath()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.0.

Véase también absolutePath().

[since 6.0] std::filesystem::path QFileInfo::filesystemCanonicalFilePath() const

Devuelve ` canonicalFilePath()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.0.

Véase también canonicalFilePath().

[since 6.0] std::filesystem::path QFileInfo::filesystemCanonicalPath() const

Devuelve ` canonicalPath()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.0.

Véase también canonicalPath().

[since 6.0] std::filesystem::path QFileInfo::filesystemFilePath() const

Devuelve filePath() como un objeto de tipo std::filesystem::path.

Esta función se introdujo en Qt 6.0.

Véase también filePath().

[since 6.2] std::filesystem::path QFileInfo::filesystemJunctionTarget() const

Devuelve ` junctionTarget()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.2.

Véase también junctionTarget().

[since 6.0] std::filesystem::path QFileInfo::filesystemPath() const

Devuelve ` path()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.0.

Véase también path().

Devuelve ` readSymLink()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.6.

Véase también readSymLink().

[since 6.0] std::filesystem::path QFileInfo::filesystemSymLinkTarget() const

Devuelve ` symLinkTarget()` como un ` std::filesystem::path`.

Esta función se introdujo en Qt 6.0.

Véase también symLinkTarget().

QString QFileInfo::group() const

Devuelve el grupo del archivo. En Windows, en sistemas en los que los archivos no tienen grupos o si se produce un error, se devuelve una cadena vacía.

Esta función puede tardar bastante en ejecutarse en Unix (del orden de milisegundos).

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también groupId(), owner() y ownerId().

uint QFileInfo::groupId() const

Devuelve el identificador del grupo al que pertenece el archivo.

En Windows y en sistemas en los que los archivos no tienen grupos, esta función siempre devuelve (uint) -2.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también group(), owner() y ownerId().

bool QFileInfo::isAbsolute() const

Devuelve « true » si la ruta de la entrada del sistema de archivos es absoluta; en caso contrario, devuelve « false » (es decir, la ruta es relativa).

Nota: Las rutas que comienzan con dos puntos (:) siempre se consideran absolutas, ya que indican un QResource.

Véase también isRelative().

[since 6.4] bool QFileInfo::isAlias() const

Devuelve ` true ` si este objeto apunta a un alias; en caso contrario, devuelve ` false`.

Los alias solo existen en macOS. Se tratan como archivos normales, por lo que al abrir un alias se abrirá el propio archivo. Para abrir el archivo o directorio al que hace referencia un alias, utiliza symLinkTarget().

Nota: Aunque un alias apunte a un archivo que no existe, isAlias() devuelve «true».

Esta función se introdujo en Qt 6.4.

Véase también isFile(), isDir(), isSymLink() y symLinkTarget().

bool QFileInfo::isBundle() const

Devuelve ` true ` si este objeto apunta a un paquete o a un enlace simbólico a un paquete en macOS e iOS; en caso contrario, devuelve ` false`.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también isDir(), isSymLink() y isFile().

bool QFileInfo::isDir() const

Devuelve « true » si este objeto apunta a un directorio o a un enlace simbólico a un directorio. Devuelve « false » si el objeto apunta a algo que no es un directorio (como un archivo) o que no existe.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véanse también isFile(), isSymLink() y isBundle().

bool QFileInfo::isExecutable() const

Devuelve ` true ` si la entrada del sistema de archivos a la que hace referencia ` QFileInfo ` es ejecutable; en caso contrario, devuelve ` false`.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también isReadable(), isWritable() y permission().

bool QFileInfo::isFile() const

Devuelve « true » si este objeto apunta a un archivo o a un enlace simbólico a un archivo. Devuelve « false » si el objeto apunta a algo que no es un archivo (como un directorio) o que no existe.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también isDir(), isSymLink() y isBundle().

bool QFileInfo::isHidden() const

Devuelve ` true ` si la entrada del sistema de archivos a la que hace referencia ` QFileInfo ` es «oculta»; en caso contrario, devuelve ` false`.

Nota: Esta función devuelve true para las entradas especiales «.» y «..» en Unix, aunque QDir::entryList las trate como se indica. Y ten en cuenta que, dado que esta función comprueba el nombre del archivo, en Unix comprobará el nombre del enlace simbólico, si este archivo es un enlace simbólico, y no el nombre del destino.

En Windows, esta función devuelve true si el archivo de destino está oculto (no el enlace simbólico).

bool QFileInfo::isJunction() const

Devuelve « true » si el objeto apunta a una unión; en caso contrario, devuelve « false ».

Las uniones solo existen en el sistema de archivos NTFS de Windows y suelen crearse mediante el comando « mklink ». Pueden considerarse enlaces simbólicos para directorios y solo pueden crearse para rutas absolutas en el volumen local.

bool QFileInfo::isNativePath() const

Devuelve « true » si la ruta del archivo se puede utilizar directamente con las API nativas. Devuelve « false » si, en caso contrario, el archivo es compatible con un sistema de archivos virtual dentro de Qt, como el Sistema de Recursos de Qt.

Nota: Las rutas nativas pueden seguir requiriendo la conversión de los separadores de ruta y la codificación de caracteres, dependiendo de la plataforma y de los requisitos de entrada de la API nativa.

Véase también QDir::toNativeSeparators(), QFile::encodeName(), filePath(), absoluteFilePath() y canonicalFilePath().

[since 6.10] bool QFileInfo::isOther() const

Devuelve « true » si este « QFileInfo » hace referencia a una entrada del sistema de archivos que no sea un directorio, un archivo normal o un enlace simbólico. En caso contrario, devuelve « false ».

Si este ` QFileInfo ` hace referencia a una entrada inexistente, este método devuelve ` false`.

Si la entrada es un enlace simbólico «colgante» (el destino no existe), este método devuelve false. En el caso de un enlace simbólico que no sea «colgante», esta función devuelve información sobre el destino, no sobre el enlace simbólico.

En Unix, una entrada especial (de otro tipo) del sistema de archivos es un FIFO, un socket, un dispositivo de caracteres o un dispositivo de bloques. Para obtener más detalles, consulta la mknod página del manual.

En Windows (por razones históricas; véase Symbolic Links and Shortcuts), este método devuelve true para los archivos .lnk.

Esta función se introdujo en Qt 6.10.

Véase también isDir(), isFile(), isSymLink() y QDirListing::IteratorFlag::ExcludeOther.

bool QFileInfo::isReadable() const

Devuelve « true » si el usuario puede leer la entrada del sistema de archivos a la que hace referencia « QFileInfo »; en caso contrario, devuelve « false ».

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Nota: Si no se ha habilitado la comprobación de NTFS permissions, el resultado en Windows solo indicará si la entrada existe.

Véase también isWritable(), isExecutable() y permission().

bool QFileInfo::isRelative() const

Devuelve « true » si la ruta de la entrada del sistema de archivos es relativa; en caso contrario, devuelve « false » (es decir, la ruta es absoluta).

En Unix, las rutas absolutas comienzan con el separador de directorios '/'. En Windows, las rutas absolutas comienzan con una especificación de unidad (por ejemplo, D:/).

Nota: Las rutas que comienzan con dos puntos (:) siempre se consideran absolutas, ya que denotan un « QResource ».

Véase también isAbsolute().

bool QFileInfo::isRoot() const

Devuelve « true » si el objeto apunta a un directorio o a un enlace simbólico a un directorio, y dicho directorio es el directorio raíz; en caso contrario, devuelve « false ».

bool QFileInfo::isShortcut() const

Devuelve ` true ` si este objeto apunta a un acceso directo; en caso contrario, devuelve ` false`.

Los accesos directos solo existen en Windows y suelen ser archivos de tipo « .lnk ». Por ejemplo, se devolverá «true» para los accesos directos (archivos de tipo «*.lnk ») en Windows, pero se devolverá «false» en Unix (incluidos macOS e iOS).

Los archivos de acceso directo (.lnk) se tratan como archivos normales. Al abrirlos, se abrirá el propio archivo « .lnk ». Para abrir el archivo al que hace referencia un acceso directo, hay que utilizar ` symLinkTarget()` sobre dicho acceso directo.

Nota: Aunque un acceso directo (acceso directo roto) apunte a un archivo que no existe, isShortcut() devuelve «true».

Véase también isFile(), isDir(), isSymbolicLink() y symLinkTarget().

Devuelve ` true ` si este objeto apunta a un enlace simbólico, un acceso directo o un alias; en caso contrario, devuelve ` false`.

Los enlaces simbólicos existen en Unix (incluidos macOS e iOS) y en Windows, y suelen crearse mediante los comandos ln -s o mklink, respectivamente. Al abrir un enlace simbólico, lo que se abre realmente es el link's target.

Además, se devolverá «true» para los accesos directos (archivos «*.lnk ») en Windows y para los alias en macOS. Este comportamiento está obsoleto y es probable que cambie en una futura versión de Qt. Al abrir un acceso directo o un alias, se abrirá el propio archivo « .lnk » o de alias.

Ejemplo:

QFileInfo info(fileName);
if (info.isSymLink())
    fileName = info.symLinkTarget();

Nota: exists() devuelve true si el enlace simbólico apunta a un destino existente; en caso contrario, devuelve false.

Véase también isFile(), isDir() y symLinkTarget().

Devuelve ` true ` si este objeto apunta a un enlace simbólico; en caso contrario, devuelve ` false`.

Los enlaces simbólicos existen en Unix (incluidos macOS e iOS) y en Windows (enlaces simbólicos NTFS) y suelen crearse mediante los comandos ln -s o mklink, respectivamente.

Unix gestiona los enlaces simbólicos de forma transparente. Al abrir un enlace simbólico, se abre efectivamente el archivo link's target.

A diferencia de ` isSymLink()`, se devolverá «false» para los accesos directos (archivos `*.lnk `) en Windows y para los alias en macOS. Utiliza en su lugar ` QFileInfo::isShortcut()` y ` QFileInfo::isAlias()`.

Nota: exists() devuelve true si el enlace simbólico apunta a un destino existente; en caso contrario, devuelve false.

Véase también isFile(), isDir(), isShortcut() y symLinkTarget().

bool QFileInfo::isWritable() const

Devuelve « true » si el usuario puede escribir en la entrada del sistema de archivos a la que hace referencia « QFileInfo »; en caso contrario, devuelve « false ».

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Nota: Si la comprobación de NTFS permissions no se ha habilitado, el resultado en Windows solo reflejará si la entrada está marcada como «Solo lectura».

Véase también isReadable(), isExecutable() y permission().

[since 6.2] QString QFileInfo::junctionTarget() const

Resuelve una unión NTFS a la ruta a la que hace referencia.

Devuelve la ruta absoluta al directorio al que apunta una unión NTFS, o una cadena vacía si el objeto no es una unión NTFS.

No hay garantía de que el directorio al que hace referencia la unión NTFS exista realmente.

Esta función se introdujo en Qt 6.2.

Véase también isJunction(), isFile(), isDir(), isSymLink(), isSymbolicLink() y isShortcut().

QDateTime QFileInfo::lastModified() const

Devuelve la fecha y la hora de la última modificación del archivo.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función sobrecarga ` QFileInfo::lastModified(const QTimeZone &)` y devuelve lo mismo que ` lastModified(QTimeZone::LocalTime)`.

Véase también birthTime(), lastRead(), metadataChangeTime() y fileTime().

[since 6.6] QDateTime QFileInfo::lastModified(const QTimeZone &tz) const

Devuelve la fecha y la hora de la última modificación del archivo.

La hora devuelta se expresa en la zona horaria especificada por tz. Por ejemplo, puedes utilizar QTimeZone::LocalTime o QTimeZone::UTC para obtener la hora en la zona horaria local o en UTC, respectivamente. Dado que la API nativa del sistema de archivos suele utilizar UTC, el uso de QTimeZone::UTC suele ser más rápido, ya que no requiere ninguna conversión.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función se introdujo en Qt 6.6.

Véase también birthTime(const QTimeZone &), lastRead(const QTimeZone &), metadataChangeTime(const QTimeZone &) y fileTime(QFileDevice::FileTime, const QTimeZone &).

QDateTime QFileInfo::lastRead() const

Devuelve la fecha y la hora en las que se leyó (se accedió a) el archivo por última vez.

En plataformas en las que esta información no está disponible, devuelve la misma hora que la función ` lastModified()`.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función sobrecarga la función ` QFileInfo::lastRead(const QTimeZone &)` y devuelve lo mismo que ` lastRead(QTimeZone::LocalTime)`.

Véase también birthTime(), lastModified(), metadataChangeTime() y fileTime().

[since 6.6] QDateTime QFileInfo::lastRead(const QTimeZone &tz) const

Devuelve la fecha y la hora en las que se leyó (se accedió a) el archivo por última vez.

La hora devuelta corresponde a la zona horaria especificada por ` tz`. Por ejemplo, puedes utilizar ` QTimeZone::LocalTime ` o ` QTimeZone::UTC ` para obtener la hora en la zona horaria local o en UTC, respectivamente. Dado que la API nativa del sistema de archivos suele utilizar UTC, el uso de ` QTimeZone::UTC ` suele ser más rápido, ya que no requiere ninguna conversión.

En plataformas en las que esta información no está disponible, devuelve la misma hora que lastModified().

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función se introdujo en Qt 6.6.

Véase también birthTime(const QTimeZone &), lastModified(const QTimeZone &), metadataChangeTime(const QTimeZone &) y fileTime(QFileDevice::FileTime, const QTimeZone &).

bool QFileInfo::makeAbsolute()

Si la ruta de la entrada del sistema de archivos es relativa, este método la convierte en una ruta absoluta y devuelve true; si la ruta ya es absoluta, este método devuelve false.

Véanse también filePath() y isRelative().

QDateTime QFileInfo::metadataChangeTime() const

Devuelve la fecha y la hora en que se modificaron por última vez los metadatos del archivo, en hora local.

Se produce un cambio en los metadatos cuando se crea el archivo por primera vez, pero también cada vez que el usuario escribe o configura información del inodo (por ejemplo, al cambiar los permisos del archivo).

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función sobrecarga QFileInfo::metadataChangeTime(const QTimeZone &tz) y devuelve lo mismo que metadataChangeTime(QTimeZone::LocalTime).

Véase también birthTime(), lastModified(), lastRead() y fileTime().

[since 6.6] QDateTime QFileInfo::metadataChangeTime(const QTimeZone &tz) const

Devuelve la fecha y la hora en las que se modificaron por última vez los metadatos del archivo. Se produce un cambio en los metadatos cuando se crea el archivo por primera vez, pero también cada vez que el usuario escribe o configura información del inodo (por ejemplo, al modificar los permisos del archivo).

La hora devuelta se expresa en la zona horaria especificada por tz. Por ejemplo, puedes utilizar QTimeZone::LocalTime o QTimeZone::UTC para obtener la hora en la zona horaria local o en UTC, respectivamente. Dado que la API nativa del sistema de archivos suele utilizar UTC, el uso de QTimeZone::UTC suele ser más rápido, ya que no requiere ninguna conversión.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Esta función se introdujo en Qt 6.6.

Véase también birthTime(const QTimeZone &), lastModified(const QTimeZone &), lastRead(const QTimeZone &) y fileTime(QFileDevice::FileTime time, const QTimeZone &).

QString QFileInfo::owner() const

Devuelve el propietario del archivo. En sistemas en los que los archivos no tienen propietario, o si se produce un error, se devuelve una cadena vacía.

Esta función puede tardar bastante en ejecutarse en Unix (del orden de milisegundos). En Windows, devolverá una cadena vacía a menos que se haya habilitado la comprobación « NTFS permissions ».

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véanse también ownerId(), group() y groupId().

uint QFileInfo::ownerId() const

Devuelve el identificador del propietario del archivo.

En Windows y en sistemas en los que los archivos no tienen propietarios, esta función devuelve ((uint) -2).

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también owner(), group() y groupId().

QString QFileInfo::path() const

Devuelve la ruta de la entrada del sistema de archivos a la que hace referencia este QFileInfo, sin incluir el nombre de la entrada.

Nota: Si a este ` QFileInfo ` se le proporciona una ruta que termina con un separador de directorios ` '/'`, la parte del nombre de la entrada se considera vacía. En este caso, esta función devolverá la ruta completa.

Véase también filePath(), absolutePath(), canonicalPath(), dir(), fileName() y isRelative().

bool QFileInfo::permission(QFileDevice::Permissions permissions) const

Comprueba los permisos de los archivos. El argumento ` permissions ` puede estar formado por varias banderas de tipo `QFile::Permissions` combinadas mediante la operación OR para comprobar distintas combinaciones de permisos.

En sistemas en los que los archivos no tienen permisos, esta función siempre devuelve ` true`.

Nota: El resultado puede ser inexacto en Windows si no se ha habilitado la comprobación de ` NTFS permissions `.

Ejemplo:

QFileInfo fi("/tmp/archive.tar.gz");
if (fi.permission(QFile::WriteUser | QFile::ReadGroup))
    qWarning("I can change the file; my group can read the file");
if (fi.permission(QFile::WriteGroup | QFile::WriteOther))
    qWarning("The group or others can change the file");

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también isReadable(), isWritable() y isExecutable().

QFileDevice::Permissions QFileInfo::permissions() const

Devuelve la combinación completa, unida mediante la operación «OR», de los permisos de QFile::Permissions para el archivo.

Nota: El resultado puede ser inexacto en Windows si no se ha habilitado la comprobación « NTFS permissions ».

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Lee la ruta a la que hace referencia el enlace simbólico.

Devuelve la ruta sin formato a la que hace referencia el enlace simbólico, sin resolver una ruta relativa con respecto al directorio que contiene dicho enlace. La cadena devuelta solo será una ruta absoluta si el enlace simbólico realmente hace referencia a ella como tal. Devuelve una cadena vacía si el objeto no es un enlace simbólico.

Esta función se introdujo en Qt 6.6.

Véase también symLinkTarget(), exists(), isSymLink(), isDir() y isFile().

void QFileInfo::refresh()

Actualiza la información sobre la entrada del sistema de archivos a la que hace referencia este QFileInfo, es decir, lee la información del sistema de archivos la próxima vez que se recupere una propiedad almacenada en caché.

void QFileInfo::setCaching(bool enable)

Si enable es verdadero, se habilita el almacenamiento en caché de la información de los archivos. Si enable es falso, el almacenamiento en caché queda deshabilitado.

Cuando el almacenamiento en caché está habilitado, ` QFileInfo ` lee la información del archivo desde el sistema de archivos la primera vez que se necesita, pero por lo general no lo vuelve a hacer posteriormente.

El almacenamiento en caché está habilitado de forma predeterminada.

Véase también refresh() y caching().

void QFileInfo::setFile(const QString &path)

Establece la ruta de la entrada del sistema de archivos sobre la que este QFileInfo proporciona información en path, que puede ser absoluta o relativa.

En Unix, las rutas absolutas comienzan con el separador de directorios '/'. En Windows, las rutas absolutas comienzan con la especificación de una unidad (por ejemplo, D:/).

Las rutas relativas comienzan con un nombre de directorio o un nombre de archivo normal y especifican la ruta de una entrada del sistema de archivos relativa al directorio de trabajo actual.

Ejemplo:

QFileInfo info("/usr/bin/env");

QString path = info.absolutePath(); // path = /usr/bin
QString base = info.baseName(); // base = env

info.setFile("/etc/hosts");

path = info.absolutePath(); // path = /etc
base = info.baseName(); // base = hosts

Véase también isFile(), isRelative(), QDir::setCurrent() y QDir::isRelativePath().

[since 6.0] void QFileInfo::setFile(const std::filesystem::path &path)

Establece la ruta de la entrada del sistema de archivos sobre la que este QFileInfo proporciona información en path.

Si path es relativa, QFileInfo también tendrá una ruta relativa.

Esta función se introdujo en Qt 6.0.

void QFileInfo::setFile(const QFileDevice &file)

Establece el archivo sobre el que la propiedad ` QFileInfo ` proporciona información en ` file`.

Si file incluye una ruta relativa, QFileInfo también tendrá una ruta relativa.

Esta es una función sobrecargada.

Véase también isRelative().

void QFileInfo::setFile(const QDir &dir, const QString &path)

Establece la ruta de la entrada del sistema de archivos sobre la que proporciona información este QFileInfo en path, dentro del directorio dir.

Si dir tiene una ruta relativa, QFileInfo también tendrá una ruta relativa.

Si path es absoluta, se ignorará el directorio especificado por dir.

Esta es una función sobrecargada.

Véase también isRelative().

qint64 QFileInfo::size() const

Devuelve el tamaño del archivo en bytes. Si el archivo no existe o no se puede recuperar, se devuelve 0.

Si el archivo es un enlace simbólico, esta función devuelve información sobre el destino, no sobre el enlace simbólico.

Véase también exists().

[since 6.0] void QFileInfo::stat()

Lee todos los atributos del sistema de archivos.

Esto resulta útil cuando la información sobre el sistema de archivos se recopila en un hilo de trabajo y, a continuación, se transmite a la interfaz de usuario en forma de instancias de ` QFileInfo ` almacenadas en caché.

Esta función se introdujo en Qt 6.0.

Véase también ` setCaching()` y ` refresh()`.

QString QFileInfo::suffix() const

Devuelve el sufijo (extensión) del archivo.

El sufijo está formado por todos los caracteres del archivo que aparecen después del último «.» (sin incluirlo).

Ejemplo:

QFileInfo fi("/tmp/archive.tar.gz");
QString ext = fi.suffix();  // ext = "gz"

El sufijo de un archivo se calcula de la misma forma en todas las plataformas, independientemente de las convenciones de nomenclatura de archivos (por ejemplo, «.bashrc» en Unix tiene un nombre base vacío, y el sufijo es «bashrc»).

Véase también fileName(), completeSuffix(), baseName() y completeBaseName().

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

Intercambia la información de este archivo con la de other. Esta operación es muy rápida y nunca falla.

QString QFileInfo::symLinkTarget() const

Devuelve la ruta absoluta al archivo o directorio al que apunta un enlace simbólico, o una cadena vacía si el objeto no es un enlace simbólico.

Es posible que este nombre no corresponda a un archivo existente; se trata únicamente de una cadena de caracteres.

Nota: La función ` exists()` devuelve ` true ` si el enlace simbólico apunta a un destino existente; en caso contrario, devuelve ` false`.

Véase también exists(), isSymLink(), isDir() y isFile().

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

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

Nota: El objeto del que se ha realizado el traslado, 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.

QFileInfo &QFileInfo::operator=(const QFileInfo &fileinfo)

Crea una copia del fileinfo especificado y la asigna a este QFileInfo.

Relacionado: No socios

QFileInfoList

Sinónimo de QList<QFileInfo>.

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

Devuelve « true » si « QFileInfo » lhs hace referencia a una entrada del sistema de archivos distinta de la indicada por « rhs »; en caso contrario, devuelve « false ».

Véase también operator==().

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

Devuelve ` true ` si ` QFileInfo `, ` lhs ` y ` QFileInfo ` ` rhs ` hacen referencia a la misma entrada del sistema de archivos; en caso contrario, devuelve ` false`.

Tenga en cuenta que el resultado de comparar dos objetos « QFileInfo » vacíos, que no contengan referencias a entradas del sistema de archivos (rutas que no existen o están vacías), es indefinido.

Advertencia: Esto no comparará dos enlaces simbólicos diferentes que apunten al mismo destino.

Advertencia: En Windows, las rutas largas y cortas que hacen referencia a la misma entrada del sistema de archivos se tratan como si se refirieran a entradas diferentes.

Véase también operator!=().

Documentación de macros

[since 6.0] QT_IMPLICIT_QFILEINFO_CONSTRUCTION

Al definir esta macro, la mayoría de los constructores de QFileInfo pasan a ser implícitos en lugar de explícitos. Dado que la creación de objetos de QFileInfo consume muchos recursos, se debe evitar crearlos accidentalmente, sobre todo si existen alternativas más eficientes. Por ejemplo:

QDirIterator it(dir);
while (it.hasNext()) {
    // Implicit conversion from QString (returned by it.next()):
    // may create unnecessary data structures and cause additional
    // accesses to the file system. Unless this macro is defined,
    // this line does not compile.

    QFileInfo fi = it.next();

    ~~~
}

En su lugar, utiliza la API adecuada:

QDirIterator it(dir);
while (it.hasNext()) {
    // Extract the QFileInfo from the iterator directly:
    QFileInfo fi = it.nextFileInfo();

    ~~~
}

La construcción a partir de QString, QFile, etc., siempre es posible utilizando la inicialización directa en lugar de la inicialización por copia:

QFileInfo fi1 = some_string; // Does not compile unless this macro is defined
QFileInfo fi2(some_string);  // OK
QFileInfo fi3{some_string};  // Possibly better, avoids the risk of the Most Vexing Parse
auto fi4 = QFileInfo(some_string); // OK

Esta macro se proporciona por motivos de compatibilidad. No se recomienda su uso en código nuevo.

Esta macro se introdujo en Qt 6.0.

© 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.