База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::filesystem::create_directories: създаване на целия път от директории

std::filesystem::create_directories създава по ред липсващите директории в път и съобщава дали е създала крайната директория.

Версия: C++23

Синтаксис

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) от <filesystem> извършва еквивалента на create_directory за всеки несъществуващ елемент на p. Връща true само ако създаде директорията, определена от целия p; ако тя вече е съществувала, връща false без грешка.

Примерът създава alpha/beta, повтаря извикването и извежда 1 0 1: първото създава целта, второто не променя нищо, а крайната директория съществува.

Това не е транзакция: ако по-късен елемент се провали, по-ранните директории може да останат. Съществуващ компонент, който не е директория, липса на права или невалиден път съобщават грешка. Хвърлящото претоварване използва filesystem_error; формата с error_code& ec съобщава чрез ec, но в C++23 не е декларирана noexcept.

Примери

#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);
}

Резултат

1 0 1

std::filesystem::create_directories → 1 0 1

Източници