Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::filesystem::remove : supprimer une entrée

std::filesystem::remove supprime un fichier ou répertoire vide et indique si une entrée existante a réellement été supprimée.

Version : 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) de <filesystem> agit comme le remove POSIX sur l’unique entrée nommée par p. Elle renvoie true après suppression et false si p n’existait pas ; l’absence n’est pas une erreur. Elle n’efface pas récursivement le contenu d’un répertoire.

L’exemple crée un fichier, appelle remove deux fois et affiche 1 0 : le premier appel supprime l’entrée, le second constate son absence. Pour tout un arbre, utilisez remove_all, dont le résultat compte les entrées supprimées.

Pour un lien symbolique, le lien lui-même est supprimé, pas sa cible. Répertoire non vide, droits insuffisants ou panne du système sont des erreurs : la surcharge lançante peut signaler filesystem_error ; la forme error_code&, noexcept, renvoie false en cas d’erreur et fixe ec.

Exemples

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

Résultat

1 0

std::filesystem::remove → 1 0

Sources