Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje