CKTIS / C++
std::filesystem::remove: één item verwijderen
std::filesystem::remove verwijdert één bestand of lege map en meldt of een bestaand item daadwerkelijk is verwijderd.
Versie: C++23
Syntax
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) uit <filesystem> werkt als POSIX remove op het ene door p benoemde item. De functie retourneert true na verwijdering en false als p niet bestond; afwezigheid is geen fout. Mapinhoud wordt niet recursief gewist.
Het voorbeeld maakt een bestand, roept remove tweemaal aan en print 1 0: de eerste aanroep verwijdert het item, de tweede ziet dat het ontbreekt. Gebruik voor een hele boom remove_all; het resultaat daarvan is het aantal verwijderde items.
Bij een symbolische link wordt de link zelf verwijderd, niet het doel. Een niet-lege map, onvoldoende rechten of bestandssysteemfout is een fout: de werpende overload kan filesystem_error melden; de error_code&-vorm is noexcept, retourneert false bij een fout en zet ec.
Voorbeelden
#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);
}
Resultaat
1 0
std::filesystem::remove → 1 0