/DirWatcher

One-header lib for watching changes in folder using WinAPI in background thread

Primary LanguageC++

DirWatcher

DirWatcher is a header-only c++ library for watching changes in folder using WinAPI. Process will run in background thread.

Dependencies:

  1. <thread> for threading
  2. <windows.h> for WinAPI calls
  3. <function> (optional, see below) for callback function

Copyright:

(c) 2017 by CIWH

License

Public domain

Usage:

  1. (Optional) You can define some actions before including:
  • DIRWATCHER_FAILED_WATCH_DIR_ACTION will be called if setting handle is failed,
  • DIRWATCHER_FAILED_CLOSE_HANDLE_ACTION will be called if closing handle failed,
  • DIRWATCHER_DEFAULT_CALLBACK_MESSAGE will be inserted as code for default callback,
  • DIRWATCHER_MESSAGE_BUFFER_SIZE is message buffer size (default is 1024 bytes)
  • DIRWATCHER_USE_STD_FUNCTION if defined - will use std::function instead of function pointer for callback
  1. #include "path/to/this/file/dirwatcher.hpp"
  2. Create object: ciwh::DirWatcher watcher;
  • Defaults: dir is ., non-recursive (dont watch subfolders)

  1. Set callback:

    watcher.setCallback([](ciwh::FileActionType type, const char* filename){
    /* your code here */
})

  2. Run: watcher.start();

  3. (Optional, will be called in destructor) Stop: watcher.stop();

You can chande dir via setDir(const char* path) method, set recursive mode via setRecursive(bool b) method. If watcher was running, it will restart.

Getters are: bool isRecursive(), bool isRunning(), const char* const getDir()