Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::filesystem::create_directories: criar todo um caminho de diretórios

std::filesystem::create_directories cria por ordem os diretórios em falta num caminho e indica se criou o diretório final.

Versão: C++23

Sintaxe

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) de <filesystem> executa o equivalente a create_directory para cada elemento inexistente de p. Devolve true apenas se criou o diretório resolvido por todo p; se este já existia, devolve false sem erro.

O exemplo cria alpha/beta, repete a chamada e imprime 1 0 1: a primeira criou o destino, a segunda nada alterou e o diretório final existe.

Não é uma transação: se um elemento posterior falhar, diretórios anteriores podem ficar. Um componente existente que não seja diretório, permissões insuficientes ou caminho inválido comunicam erro. A sobrecarga que lança usa filesystem_error; a forma com error_code& ec comunica por ec, mas em C++23 não está declarada noexcept.

Exemplos

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

Resultado

1 0 1

std::filesystem::create_directories → 1 0 1

Fontes