SaneCppFileSystem.h is a library enabling manipulation of files and directories.

Quick Sheet

Dependencies

• Dependencies: (none)
• All dependencies: (none)

Features

Status

Usable The library contains commonly used function including links, access checks and richer path metadata. Some lower level filesystem features are still missing, especially filesystem-level queries. SC::FileSystem::getFileTime and SC::FileSystem::setLastModifiedTime will probably be refactored in a future dedicated class for handling stat based operations.

Blog

Some relevant blog posts are:

• July 2025 Update
• March 2026 Update

Description

SC::FileSystem allows all typical file operations ( exists | copy | delete | make files or directory). Some less used functions are SC::FileSystem::getFileTime and SC::FileSystem::setLastModifiedTime . The library also supports symlink and hardlink creation, reading symlink targets and checking path accessibility. The library doesn't allow reading or writing seeking inside a file, as that is domain of the File library. SC::FileSystem::init needs an absolute path to a directory and makes it a the base directory. All paths passed later on as arguments to all methods can be either absolute paths or relative. If they are relative, they will be interpreted as relative to the base directory and NOT current directory of the process. The class wants explicitly to make sure its behavior doesn't implicitly depend on current directory of process (unless it's passed explicitly to SC::FileSystem::init of course).

Use SC::Path from Strings library to parse and compose paths.

FileSystem

copyFile

copyDirectory

removeDirectoryRecursive

makeDirectoryRecursive

existsAndIsFile

existsAndIsDirectory

rename

createSymbolicLink

createHardLink

existsAndIsLink

canAccess

stat

lstat

readSymbolicLink

chmod

chown

lchown

lchmod

write

read

Roadmap

Complete Features:

• statfs

Statistics