Struct FileEventHandlers

Struct Documentation

struct FileEventHandlers

Owned file-lifecycle callbacks invoked by backend operations, not marshalled onto the application thread.

Paths and FILE pointers are borrowed only for the invocation. Opening callbacks may reject construction; closing failures are contained and reported after delegate locks unwind. Protect captures through final closure. Recursive ordinary logging is suppressed, and blocking/lifecycle reentry rejects.

Public Members

std::function<void(const std::filesystem::path&)> before_open

Optional callback before opening; exceptions can reject construction.

std::function<void(const std::filesystem::path&, std::FILE*)> after_open

Optional callback after opening; stream is borrowed and must not be retained/closed.

std::function<void(const std::filesystem::path&, std::FILE*)> before_close

Optional callback before final stream closure; failures are contained.

std::function<void(const std::filesystem::path&)> after_close

Optional callback after closure; only the borrowed path is available.