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

CKTIS / C++

std::filesystem::remove: remover uma entrada

std::filesystem::remove remove um ficheiro ou diretório vazio e indica se uma entrada existente foi realmente removida.

Versão: C++23

Sintaxe

bool std::filesystem::remove(const std::filesystem::path& p);

bool std::filesystem::remove(
    const std::filesystem::path& p, std::error_code& ec) noexcept;

std::filesystem::remove(p) de <filesystem> age como o remove POSIX sobre a única entrada nomeada por p. Devolve true se a remove e false se p não existia; a ausência não é erro. Não apaga recursivamente o conteúdo de um diretório.

O exemplo cria um ficheiro, chama remove duas vezes e imprime 1 0: a primeira chamada remove a entrada e a segunda observa a ausência. Para uma árvore completa usa remove_all, cujo resultado conta as entradas removidas.

Num link simbólico remove-se o próprio link, não o destino. Diretório não vazio, permissões insuficientes ou falha do sistema são erros: a sobrecarga que lança pode comunicar filesystem_error; a forma error_code& é noexcept, devolve false em erro e define ec.

Exemplos

#include <filesystem>
#include <fstream>
#include <iostream>

int main() {
    namespace fs = std::filesystem;
    const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-remove";
    const fs::path file = root / "item.txt";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directory(root);
    std::ofstream(file) << "data";

    const bool first = fs::remove(file);
    const bool second = fs::remove(file);
    std::cout << first << ' ' << second << '\n';

    fs::remove_all(root, ignored);
}

Resultado

1 0

std::filesystem::remove → 1 0

Fontes