Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::filesystem::remove: rimuovere una voce

std::filesystem::remove elimina un file o una directory vuota e indica se una voce esistente è stata davvero rimossa.

Versione: C++23

Sintassi

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) di <filesystem> agisce come remove POSIX sulla singola voce indicata da p. Restituisce true se la rimuove e false se p non esisteva; l’assenza non è un errore. Non cancella ricorsivamente il contenuto di una directory.

L’esempio crea un file, chiama remove due volte e stampa 1 0: la prima chiamata rimuove la voce, la seconda ne osserva l’assenza. Per un intero albero usa remove_all, il cui risultato conta le voci eliminate.

Per un link simbolico viene eliminato il link, non la destinazione. Directory non vuota, permessi insufficienti o errore del filesystem sono errori: l’overload che lancia può segnalare filesystem_error; la forma error_code& è noexcept, restituisce false in errore e imposta ec.

Esempi

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

Risultato

1 0

std::filesystem::remove → 1 0

Fonti