CKTIS / C++
std::filesystem::remove: odstranění jedné položky
std::filesystem::remove odstraní jeden soubor nebo prázdný adresář a oznámí, zda existující položku skutečně odstranila.
Verze: C++23
Syntaxe
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> působí jako POSIX remove na jedinou položku pojmenovanou p. Po odstranění vrátí true, při neexistujícím p false; nepřítomnost není chyba. Obsah adresáře nemaže rekurzivně.
Příklad vytvoří soubor, zavolá remove dvakrát a vypíše 1 0: první volání položku odstraní a druhé zjistí její nepřítomnost. Pro celý strom použijte remove_all, jehož výsledek udává počet odstraněných položek.
U symbolického odkazu se odstraní samotný odkaz, ne jeho cíl. Neprázdný adresář, nedostatečná práva nebo chyba systému jsou chyby: vyhazující přetížení může hlásit filesystem_error; forma error_code& je noexcept, při chybě vrátí false a nastaví ec.
Příklady
#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);
}
Výsledek
1 0
std::filesystem::remove → 1 0