std::filesystem::directory_entry::exists

bool exists() const;	(1)	(начиная с C++17)
bool exists( std::error_code& ec ) const noexcept;	(2)	(начиная с C++17)

Проверяет, существует ли объект, на который указывает путь. Фактически возвращает:

1) std::filesystem::exists(status()),

2) std::filesystem::exists(status(ec)).

Обратите внимание, что status() следует по символическим ссылкам к их целевым объектам.

Параметры

выходной параметр для сообщения об ошибках в перегрузке без исключений

Возвращаемое значение

true, если объект файловой системы, на который указывает путь, существует.

Исключения

Любая перегрузка, не помеченная как noexcept, может выбросить std::bad_alloc при сбое выделения памяти.

1) Выбрасывает std::filesystem::filesystem_error при ошибках нижележащего API ОС; исключение создаётся с p в качестве первого аргумента-пути и кодом ошибки ОС в качестве аргумента кода ошибки.

2) Устанавливает параметр std::error_code& в код ошибки API ОС, если вызов API ОС завершается с ошибкой, и выполняет ec.clear(), если ошибок нет.

Пример

#include <filesystem>
#include <iostream>

int main()
{
    for (auto const str:
    {
        "/usr/bin/cat",
        "/usr/bin/mouse",
        "/usr/bin/python",
        "/usr/bin/bison",
        "/usr/bin/yacc",
        "/usr/bin/c++",
    })
    {
        std::filesystem::directory_entry entry{str};

        std::cout << "directory entry " << entry
                  << (entry.exists() ? " exists\n" : " does not exist\n");
    }
}

Возможный вывод:

// Output on a POSIX system:
directory entry "/usr/bin/cat" exist
directory entry "/usr/bin/mouse" does not exist
directory entry "/usr/bin/python" exists
directory entry "/usr/bin/bison" exists
directory entry "/usr/bin/yacc" does not exist
directory entry "/usr/bin/c++" exists

См. также

exists

(C++17)

проверяет, указывает ли путь на существующий объект файловой системы
(функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/filesystem/directory_entry/exists