QFileSystemWatcher 使用指南

当我们的应用程序需要及时响应文件系统的变化，比如添加、删除或修改文件时，我们需要一种方法来实现这一功能。这时，我们就需要使用 Qt 的类——QFileSystemWatcher。该类能够实时监测指定目录中的文件变化，并及时通知应用程序。

一、QFileSystemWatcher介绍

QFileSystemWatcher 是 Qt 中的一个类，其主要作用是监测文件系统中指定的目录或文件的变化，并在发生变化时发出信号，提供及时的通知。

二、如何使用QFileSystemWatcher

使用 QFileSystemWatcher 类非常简单，只需实例化该类并调用 addPath() 函数来添加需要监测的文件或目录即可。当文件系统中这些文件或目录发生变化时，QFileSystemWatcher 会自动发出信号并通知应用程序。

#include <QFileSystemWatcher>
#include <QDebug>
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    QFileSystemWatcher watcher;
    watcher.addPath("/path/to/watched/file");
    QObject::connect(&watcher, SIGNAL(fileChanged(QString)), &a, SLOT(quit()));
    return a.exec();
}

上面的代码中，我们首先实例化了一个 QFileSystemWatcher 对象，然后调用了该对象的 addPath() 函数来添加需要监测的文件路径。最后，使用 QObject::connect() 函数将 QFileSystemWatcher 的 fileChanged() 信号连接到 QCoreApplication 的 quit() 槽函数上，当文件发生变化时，程序会自动退出。

三、QFileSystemWatcher的信号和槽

QFileSystemWatcher 提供了多个信号和槽函数，用于不同的文件或目录变化事件。下面是 QFileSystemWatcher 常用的信号和槽函数：

1. directoryChanged()信号

当监测的目录发生变化时，QFileSystemWatcher 会发出 directoryChanged() 信号，并将目录路径作为参数传递给槽函数。下面是一个简单的例子：

QFileSystemWatcher watcher;
watcher.addPath("/path/to/directory");
QObject::connect(&watcher, SIGNAL(directoryChanged(QString)), object, SLOT(directoryChanged(QString)));

当监测的目录发生变化时，QFileSystemWatcher 会自动发出 directoryChanged() 信号，并将目录路径作为参数传递给槽函数。

2. fileChanged()信号

当监测的文件发生变化时，QFileSystemWatcher 会发出 fileChanged() 信号，并将文件路径作为参数传递给槽函数。下面是一个例子：

QFileSystemWatcher watcher;
watcher.addPath("/path/to/file");
QObject::connect(&watcher, SIGNAL(fileChanged(QString)), object, SLOT(fileChanged(QString)));

当监测的文件发生变化时，QFileSystemWatcher 会自动发出 fileChanged() 信号，并将文件路径作为参数传递给槽函数。

3. directoryChanged()和fileChanged()信号的区别

directoryChanged() 和 fileChanged() 信号的区别在于：directoryChanged() 信号会在监测的目录和其子目录中所有的文件或子目录发生变化时都会触发，而 fileChanged() 信号只会在监测的文件本身发生变化时触发。

四、QFileSystemWatcher的平台支持

QFileSystemWatcher 在不同操作系统平台的支持可能存在一些差异。在 Windows 平台上，QFileSystemWatcher 使用了 Windows 系统中的 FindFirstChangeNotification 和 ReadDirectoryChangesW API 来监测文件或目录的变化。在 Linux 平台上，QFileSystemWatcher 使用的是 inotify 机制。在 Mac OS X 上，QFileSystemWatcher 使用的是 FSEvents。QFileSystemWatcher 尽可能地针对不同的操作系统平台提供了统一的接口，使得它能够在不同平台上实现文件监测功能。

五、总结

QFileSystemWatcher 是一个非常强大的类，能够帮助我们实现文件监测的功能。通过 QFileSystemWatcher，我们可以轻松实现对文件或目录的变化进行实时监测，并以此实现文件系统变化的实时响应。

QFileSystemWatcher：文件监测的强大工具