Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła