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

CKTIS / C++

std::filesystem::exists : tester un état de chemin connu

std::filesystem::exists renvoie true lorsque l’état du chemin est connu et différent de file_type::not_found.

Version : C++23

Syntaxe

bool std::filesystem::exists(std::filesystem::file_status s) noexcept;

bool std::filesystem::exists(const std::filesystem::path& p);

bool std::filesystem::exists(
    const std::filesystem::path& p, std::error_code& ec) noexcept;

std::filesystem::exists(p) de <filesystem> obtient status(p), suit donc par défaut un lien symbolique, puis teste status_known(s) && s.type() != file_type::not_found. Une surcharge qui ne lève pas d’exception accepte aussi un file_status déjà obtenu.

L’exemple crée un fichier, le teste ainsi qu’un chemin absent avec la surcharge error_code, puis affiche 1 0 0 : le fichier existe, l’autre non et une absence ordinaire ne laisse pas d’erreur.

false ne signifie pas toujours « certainement absent » : un refus de permission ou une autre erreur peut empêcher de connaître l’état. Avec ec, examinez résultat et ec ; si l’état est connu, la fonction efface ec. Un lien pendant donne false car status suit sa cible ; testez le lien lui-même avec symlink_status puis exists(file_status).

Exemples

#include <filesystem>
#include <fstream>
#include <iostream>

int main() {
    namespace fs = std::filesystem;
    const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-exists";
    const fs::path file = root / "item.txt";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directory(root);
    std::ofstream(file) << "data";

    std::error_code ec;
    const bool present = fs::exists(file, ec);
    const bool missing = fs::exists(root / "missing.txt", ec);
    std::cout << present << ' ' << missing << ' ' << static_cast<bool>(ec) << '\n';

    fs::remove_all(root, ignored);
}

Résultat

1 0 0

std::filesystem::exists → 1 0 0

Sources