CKTIS / C++
std::filesystem::remove: usunięcie jednego wpisu
std::filesystem::remove usuwa pojedynczy plik lub pusty katalog i zwraca, czy wpis rzeczywiście istniał oraz został usunięty.
Wersja: C++23
Składnia
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) z <filesystem> działa jak POSIX remove: usuwa jeden wpis wskazany przez p. Zwraca true, gdy plik usunięto, a false, gdy p nie istniało; nieobecność nie jest błędem. Nie usuwa rekurencyjnie zawartości katalogu.
Przykład tworzy plik, wywołuje remove dwa razy i drukuje 1 0: pierwsze wywołanie usuwa wpis, drugie stwierdza jego brak. Do całego drzewa służy osobne remove_all, którego wynik jest liczbą usuniętych wpisów.
Dla dowiązania symbolicznego usuwane jest samo dowiązanie, nie jego cel. Niepusty katalog, brak uprawnień lub błąd systemu plików są błędami: przeciążenie rzucające może zgłosić filesystem_error, a wariant error_code& jest noexcept, zwraca false przy błędzie i ustawia ec.
Przykłady
#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);
}
Wynik
1 0
std::filesystem::remove → 1 0