CKTIS / C++
std::filesystem::exists: test známého stavu cesty
std::filesystem::exists vrátí true, když je stav cesty známý a není file_type::not_found.
Verze: 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) z <filesystem> získá status(p), takže standardně následuje symbolický odkaz, a testuje status_known(s) && s.type() != file_type::not_found. Nevyhazující přetížení přijímá i již získaný file_status.
Příklad vytvoří soubor, zkontroluje jej i chybějící cestu přetížením s error_code a vypíše 1 0 0: soubor existuje, cesta ne a běžná nepřítomnost nezanechala chybu.
false nemusí znamenat „jistě neexistuje“: nedostatek práv nebo jiná chyba mohou zabránit zjištění stavu. U ec kontrolujte výsledek i ec; je-li stav známý, funkce ec vyčistí. Visící odkaz dá false, protože status následuje cíl; samotný odkaz testujte přes symlink_status a exists(file_status).
Příklady
#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);
}
Výsledek
1 0 0
std::filesystem::exists → 1 0 0