CKTIS / C++
std::filesystem::create_directories: tworzenie całej ścieżki katalogów
std::filesystem::create_directories tworzy po kolei brakujące katalogi ścieżki i zwraca, czy utworzył katalog końcowy.
Wersja: C++23
Składnia
bool std::filesystem::create_directories(const std::filesystem::path& p);
bool std::filesystem::create_directories(
const std::filesystem::path& p, std::error_code& ec);std::filesystem::create_directories(p) z <filesystem> wywołuje odpowiednik create_directory dla każdego nieistniejącego elementu p. Zwraca true tylko wtedy, gdy utworzono katalog, do którego prowadzi całe p; gdy już istniał, zwraca false bez błędu.
Przykład tworzy zagnieżdżone alpha/beta, powtarza wywołanie i drukuje 1 0 1: pierwsze utworzyło cel, drugie niczego nie zmieniło, a końcowy katalog istnieje.
To nie jest transakcja: gdy późniejszy element zawiedzie, wcześniej utworzone katalogi mogą pozostać. Istniejący składnik niebędący katalogiem, brak uprawnień lub niepoprawna ścieżka powodują błąd. Przeciążenie rzucające używa filesystem_error; wariant z error_code& ec raportuje błąd przez ec, lecz sam nie ma w C++23 deklaracji noexcept.
Przykłady
#include <filesystem>
#include <iostream>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-create-directories";
const fs::path nested = root / "alpha" / "beta";
std::error_code ignored;
fs::remove_all(root, ignored);
const bool first = fs::create_directories(nested);
const bool second = fs::create_directories(nested);
std::cout << first << ' ' << second << ' ' << fs::is_directory(nested) << '\n';
fs::remove_all(root, ignored);
}
Wynik
1 0 1
std::filesystem::create_directories → 1 0 1