WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::filesystem::exists: bekannten Pfadstatus prüfen

std::filesystem::exists liefert true, wenn der Pfadstatus bekannt und nicht file_type::not_found ist.

Version: C++23

Syntax

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) aus <filesystem> ermittelt status(p), folgt also standardmäßig einem Symlink, und prüft status_known(s) && s.type() != file_type::not_found. Ein nichtwerfender Overload nimmt auch einen vorhandenen file_status.

Das Beispiel erstellt eine Datei, prüft sie und einen fehlenden Pfad mit dem error_code-Overload und gibt 1 0 0 aus: Datei vorhanden, Pfad nicht vorhanden, gewöhnliches Fehlen ohne Fehler.

false bedeutet nicht immer „sicher nicht vorhanden“: fehlende Rechte oder ein anderer Fehler können die Statusbestimmung verhindern. Beim ec-Overload Ergebnis und ec prüfen; bei bekanntem Status wird ec gelöscht. Ein hängender Symlink ergibt false, weil status seinem Ziel folgt; für den Link selbst symlink_status und exists(file_status) verwenden.

Beispiele

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

Ergebnis

1 0 0

std::filesystem::exists → 1 0 0

Quellen