CKTIS / C++
std::filesystem::remove: odstránenie jednej položky
std::filesystem::remove odstráni jeden súbor alebo prázdny adresár a oznámi, či existujúcu položku skutočne odstránila.
Verzia: 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) z <filesystem> pôsobí ako POSIX remove na jedinú položku pomenovanú p. Po odstránení vráti true, pri neexistujúcom p false; neprítomnosť nie je chyba. Obsah adresára nemaže rekurzívne.
Príklad vytvorí súbor, zavolá remove dvakrát a vypíše 1 0: prvé volanie položku odstráni a druhé zistí jej neprítomnosť. Na celý strom použite remove_all, ktorého výsledok udáva počet odstránených položiek.
Pri symbolickom odkaze sa odstráni samotný odkaz, nie jeho cieľ. Neprázdny adresár, nedostatočné práva alebo chyba systému sú chyby: vyhadzujúce preťaženie môže hlásiť filesystem_error; forma error_code& je noexcept, pri chybe vráti false a nastaví ec.
Prí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ýsledok
1 0
std::filesystem::remove → 1 0