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