std::filesystem::directory_entry::is_directory - cppreference.com (original) (raw)
| bool is_directory() const; | (1) | (since C++17) |
|---|---|---|
| (2) | (since C++17) |
Checks whether the pointed-to object is a directory. Effectively returns:
[edit] Parameters
| ec | - | out-parameter for error reporting in the non-throwing overload |
|---|
[edit] Return value
true if the referred-to filesystem object is a directory, false otherwise.
[edit] Exceptions
Any overload not marked noexcept may throw std::bad_alloc if memory allocation fails.
Throws std::filesystem::filesystem_error on underlying OS API errors, constructed with p as the first path argument and the OS error code as the error code argument.
Sets a std::error_code& parameter to the OS API error code if an OS API call fails, and executes ec.clear() if no errors occur.
[edit] Example
#include #include #include namespace fs = std::filesystem; void check_directory(fs::directory_entry const& d, std::string_view rem = "") { std::cout << "is_directory(" << d << "): " << d.is_directory() << rem << '\n'; } int main() { fs::directory_entry d1("."); fs::directory_entry d2("file.txt"); fs::directory_entry d3("new_dir"); std::cout << std::boolalpha; check_directory(d1); check_directory(d2); check_directory(d3, " (has not been created yet)."); std::filesystem::create_directory("new_dir"); check_directory(d3, " (before refresh)."); d3.refresh(); check_directory(d3, " (after refresh)."); }
Possible output:
is_directory("."): true is_directory("file.txt"): false is_directory("new_dir"): false (has not been created yet). is_directory("new_dir"): false (before refresh). is_directory("new_dir"): true (after refresh).