QFileSystemWatcher Class
La clase `QFileSystemWatcher` ofrece una interfaz para supervisar los cambios que se producen en archivos y directorios. Más información...
| Encabezado: | #include <QFileSystemWatcher> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QObject |
- Lista de todos los miembros, incluidos los heredados
- QFileSystemWatcher forma parte de Entrada/Salida y Redes.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QFileSystemWatcher(QObject *parent = nullptr) | |
| QFileSystemWatcher(const QStringList &paths, QObject *parent = nullptr) | |
| virtual | ~QFileSystemWatcher() |
| bool | addPath(const QString &path) |
| QStringList | addPaths(const QStringList &paths) |
| QStringList | directories() const |
| QStringList | files() const |
| bool | removePath(const QString &path) |
| QStringList | removePaths(const QStringList &paths) |
Señales
| void | directoryChanged(const QString &path) |
| void | fileChanged(const QString &path) |
Descripción detallada
QFileSystemWatcher supervisa el sistema de archivos en busca de cambios en archivos y directorios mediante el seguimiento de una lista de rutas especificadas.
Llama a ` addPath()` para supervisar un archivo o directorio concreto. Se pueden añadir varias rutas mediante la función ` addPaths()`. Las rutas existentes se pueden eliminar utilizando las funciones ` removePath()` y ` removePaths()`.
QFileSystemWatcher examina cada ruta que se le añade. Se puede acceder a los archivos que se han añadido al QFileSystemWatcher mediante la función ` files()`, y a los directorios mediante la función ` directories()`.
La señal fileChanged() se emite cuando un archivo ha sido modificado, renombrado o eliminado del disco. Del mismo modo, la señal directoryChanged() se emite cuando se modifica o elimina un directorio o su contenido. Ten en cuenta que QFileSystemWatcher deja de supervisar los archivos una vez que han sido renombrados o eliminados del disco, y los directorios una vez que han sido eliminados del disco.
- Notas:
- En sistemas que ejecutan un núcleo de Linux sin soporte para inotify, no se pueden desmontar los sistemas de archivos que contienen rutas vigiladas.
- La supervisión de archivos y directorios en busca de modificaciones consume recursos del sistema. Esto implica que existe un límite en el número de archivos y directorios que tu proceso puede supervisar simultáneamente. En todas las variantes de BSD, por ejemplo, se requiere un descriptor de archivo abierto para cada archivo supervisado. Algunos sistemas limitan el número de descriptores de archivo abiertos a 256 de forma predeterminada. Esto significa que las funciones ` addPath()` y ` addPaths()` fallarán si tu proceso intenta añadir más de 256 archivos o directorios al monitor del sistema de archivos. Ten en cuenta también que tu proceso puede tener otros descriptores de archivo abiertos además de los correspondientes a los archivos supervisados, y que estos otros descriptores abiertos también cuentan para el total. macOS utiliza un backend diferente y no presenta este problema.
Documentación de funciones de miembro
QFileSystemWatcher::QFileSystemWatcher(QObject *parent = nullptr)
Crea un nuevo objeto de vigilancia del sistema de archivos con el ` parent` indicado.
QFileSystemWatcher::QFileSystemWatcher(const QStringList &paths, QObject *parent = nullptr)
Crea un nuevo objeto de vigilancia del sistema de archivos con el « parent » indicado, que supervisa la lista « paths » especificada.
[virtual noexcept] QFileSystemWatcher::~QFileSystemWatcher()
Elimina el observador del sistema de archivos.
bool QFileSystemWatcher::addPath(const QString &path)
Añade path al observador del sistema de archivos si path existe. La ruta no se añade si no existe o si ya está siendo supervisada por el observador del sistema de archivos.
Si path especifica un directorio, se emitirá la señal directoryChanged() cuando path se modifique o se elimine del disco; en caso contrario, se emitirá la señal fileChanged() cuando path se modifique, se renombre o se elimine.
Si la vigilancia se ha realizado correctamente, se devuelve «true».
Las causas de un fallo en la supervisión suelen depender del sistema, pero pueden incluir que el recurso no exista, fallos de acceso o que se haya alcanzado el límite total de supervisiones, si la plataforma lo tiene.
Nota: Puedehaber un límite, dependiente del sistema, en el número de archivos y directorios que se pueden supervisar simultáneamente. Si se alcanza este límite, path no se supervisará y se devuelve «false».
Véase también addPaths() y removePath().
QStringList QFileSystemWatcher::addPaths(const QStringList &paths)
Añade cada ruta de paths al observador del sistema de archivos. Las rutas no se añaden si no existen o si ya están siendo supervisadas por el observador del sistema de archivos.
Si una ruta especifica un directorio, se emitirá la señal « directoryChanged()» cuando la ruta se modifique o se elimine del disco; en caso contrario, se emitirá la señal « fileChanged()» cuando la ruta se modifique, se renombre o se elimine.
El valor de retorno es una lista de rutas que no se han podido supervisar.
Las causas de un fallo en la supervisión suelen depender del sistema, pero pueden incluir la inexistencia del recurso, fallos de acceso o el límite total de supervisiones, si la plataforma lo tiene.
Nota: Puede haber un límite, que depende del sistema, en el número de archivos y directorios que se pueden supervisar simultáneamente. Si se ha alcanzado este límite, los paths que sobren no se supervisarán y se añadirán a la lista QStringList devuelta.
Véase también addPath() y removePaths().
QStringList QFileSystemWatcher::directories() const
Devuelve una lista de rutas a los directorios que se están supervisando.
Véase también files().
[private signal] void QFileSystemWatcher::directoryChanged(const QString &path)
Esta señal se emite cuando se modifica el directorio situado en una dirección específica path (por ejemplo, al añadir o eliminar un archivo) o cuando se elimina del disco. Ten en cuenta que, si se producen varios cambios en un breve periodo de tiempo, es posible que algunos de ellos no emitan esta señal. Sin embargo, el último cambio de la secuencia siempre generará esta señal.
Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.
Véase también fileChanged().
[private signal] void QFileSystemWatcher::fileChanged(const QString &path)
Esta señal se emite cuando el archivo situado en la ruta especificada path se modifica, se le cambia el nombre o se elimina del disco.
Nota: Como medida de seguridad, muchas aplicaciones guardan un archivo abierto creando un nuevo archivo y, a continuación, eliminando el antiguo. En tu función de ranura, puedes comprobar watcher.files().contains(path). Si devuelve false, comprueba si el archivo sigue existiendo y, a continuación, llama a addPath() para seguir supervisándolo.
Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.
Véase también directoryChanged().
QStringList QFileSystemWatcher::files() const
Devuelve una lista de las rutas de los archivos que se están supervisando.
Véase también directories().
bool QFileSystemWatcher::removePath(const QString &path)
Elimina el « path » especificado del observador del sistema de archivos.
Si la vigilancia se elimina correctamente, se devuelve «true».
Los motivos por los que puede fallar la eliminación de una vigilancia suelen depender del sistema, pero pueden deberse, por ejemplo, a que la ruta ya se haya eliminado.
Véanse también removePaths() y addPath().
QStringList QFileSystemWatcher::removePaths(const QStringList &paths)
Elimina la ruta especificada paths del observador del sistema de archivos.
El valor devuelto es una lista de las rutas que no se han podido eliminar correctamente de la lista de seguimiento.
Los motivos por los que falla la eliminación de la vigilancia suelen depender del sistema, pero pueden deberse, por ejemplo, a que la ruta ya se haya eliminado.
Véanse también removePath() y addPaths().
© 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.