std::filesystem::directory_entry::exists

bool exists() const;	(1)	(since C++17)
bool exists( std::error_code& ec ) const noexcept;	(2)	(since 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/w/cpp/filesystem/directory_entry/exists