Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła