WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::filesystem::remove: einen Eintrag entfernen

std::filesystem::remove entfernt eine Datei oder ein leeres Verzeichnis und meldet, ob ein vorhandener Eintrag tatsächlich gelöscht wurde.

Version: 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) aus <filesystem> wirkt wie POSIX remove auf den einzelnen durch p benannten Eintrag. Es liefert true nach Entfernung und false, wenn p nicht existierte; Abwesenheit ist kein Fehler. Verzeichnisinhalte werden nicht rekursiv gelöscht.

Das Beispiel erstellt eine Datei, ruft remove zweimal auf und gibt 1 0 aus: zuerst wird der Eintrag entfernt, danach seine Abwesenheit erkannt. Für einen ganzen Baum dient remove_all; dessen Ergebnis ist die Anzahl entfernter Einträge.

Bei einem symbolischen Link wird der Link selbst, nicht sein Ziel entfernt. Ein nichtleeres Verzeichnis, fehlende Rechte oder ein Dateisystemfehler sind Fehler: Der werfende Overload kann filesystem_error melden; die error_code&-Form ist noexcept, liefert bei Fehler false und setzt ec.

Beispiele

#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);
}

Ergebnis

1 0

std::filesystem::remove → 1 0

Quellen