std::filesystem

Пространство имён std::filesystem (заголовок <filesystem>, в коде почти всегда заводят алиас namespace fs = std::filesystem;) — набор типов и функций для работы с путями и файловой системой без привязки к платформе. Центральный тип — fs::path: представление пути, которое одинаково понимает '/' и '\', умеет склеиваться оператором / и разбираться на компоненты (stem(), extension(), parent_path()). Обход директорий даёт directory_iterator (один уровень) и recursive_directory_iterator (рекурсивно, включая поддиректории). Свободные функции покрывают типичные операции: exists(), is_directory(), is_regular_file(), file_size(), create_directory(), create_directories(), remove(), remove_all(), copy(), rename().The std::filesystem namespace (header <filesystem>, code almost always sets up an alias namespace fs = std::filesystem;) is a set of types and functions for working with paths and the filesystem without tying code to a platform. The central type is fs::path: a path representation that understands both '/' and '\' equally, can be joined with the / operator, and can be broken into components (stem(), extension(), parent_path()). Directory traversal is provided by directory_iterator (one level) and recursive_directory_iterator (recursive, including subdirectories). Free functions cover the typical operations: exists(), is_directory(), is_regular_file(), file_size(), create_directory(), create_directories(), remove(), remove_all(), copy(), rename().

#ifdef _WIN32
#include <windows.h>
bool dirExists(const std::string& p) {
    auto attr = GetFileAttributesA(p.c_str());
    return attr != INVALID_FILE_ATTRIBUTES
        && (attr & FILE_ATTRIBUTE_DIRECTORY);
}
#else
#include <sys/stat.h>
bool dirExists(const std::string& p) {
    struct stat st;
    return stat(p.c_str(), &st) == 0 && S_ISDIR(st.st_mode);
}
#endif
// либо то же самое, но через внешнюю зависимость boost::filesystem// or the same thing via the external boost::filesystem dependency

#include <filesystem>
namespace fs = std::filesystem;

bool dirExists(const fs::path& p) {
    return fs::is_directory(p);  // одна строка, любая платформа// one line, any platform
}

Работа с файловой системой оставалась одной из немногих повседневных задач, у которых в стандартной библиотеке вообще не было решения:Working with the filesystem remained one of the few everyday tasks that had no solution in the standard library at all:

Типичный код обхода директории и работы с путём выглядит так:Typical directory-traversal and path-manipulation code looks like this:

#include <filesystem>
namespace fs = std::filesystem;

fs::path dir = "/data/logs";
for (const auto& entry : fs::recursive_directory_iterator(dir)) {
    if (entry.is_regular_file() && entry.path().extension() == ".log") {
        std::cout << entry.path() << " — "
                  << fs::file_size(entry.path()) << " bytes\n";
    }
}

// склейка путей — оператор /, а не конкатенация строк:// joining paths — the / operator, not string concatenation:
fs::path full = dir / "2026-07-27" / "app.log";
fs::create_directories(full.parent_path());  // создаёт все недостающие директории цепочкой// creates every missing directory in the chain

Ключевая развилка API — обработка ошибок. Почти каждая функция существует в двух вариантах: без последнего аргумента она бросает исключение fs::filesystem_error при сбое, а с последним аргументом std::error_code& — вместо исключения просто заполняет этот код и возвращает значение по умолчанию:The key API fork is error handling. Almost every function exists in two forms: without a trailing argument it throws an fs::filesystem_error exception on failure, and with a trailing std::error_code& argument it fills that code instead of throwing and returns a default value:

// стиль 1 — исключения:// style 1 — exceptions:
try {
    fs::remove("/tmp/maybe-missing.txt");
} catch (const fs::filesystem_error& e) {
    std::cerr << e.what() << '\n';
}

// стиль 2 — error_code, без throw:// style 2 — error_code, no throw:
std::error_code ec;
fs::remove("/tmp/maybe-missing.txt", ec);
if (ec) { std::cerr << ec.message() << '\n'; }

• cppreference — Filesystem library
• WG21 P0218 — Merge the Filesystem TS to C++17