KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::filesystem::remove: één item verwijderen

std::filesystem::remove verwijdert één bestand of lege map en meldt of een bestaand item daadwerkelijk is verwijderd.

Versie: 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) uit <filesystem> werkt als POSIX remove op het ene door p benoemde item. De functie retourneert true na verwijdering en false als p niet bestond; afwezigheid is geen fout. Mapinhoud wordt niet recursief gewist.

Het voorbeeld maakt een bestand, roept remove tweemaal aan en print 1 0: de eerste aanroep verwijdert het item, de tweede ziet dat het ontbreekt. Gebruik voor een hele boom remove_all; het resultaat daarvan is het aantal verwijderde items.

Bij een symbolische link wordt de link zelf verwijderd, niet het doel. Een niet-lege map, onvoldoende rechten of bestandssysteemfout is een fout: de werpende overload kan filesystem_error melden; de error_code&-vorm is noexcept, retourneert false bij een fout en zet ec.

Voorbeelden

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

Resultaat

1 0

std::filesystem::remove → 1 0

Bronnen