std::filesystem::directory_entry::directory_entry

 
 
 
 
directory_entry() noexcept = default;
(1) (C++17 起)
directory_entry( const directory_entry& ) = default;
(2) (C++17 起)
directory_entry( directory_entry&& ) noexcept = default;
(3) (C++17 起)
explicit directory_entry( const std::filesystem::path& p );
directory_entry( const std::filesystem::path& p, std::error_code& ec );
(4) (C++17 起)

构造新的 directory_entry 对象。

1) 默认构造函数。
2) 默认的复制构造函数。
3) 默认的移动构造函数。
4) 以路径 p 初始化 directory_entry ,并调用 refresh 更新缓存的属性。若发生错误,则不抛出重载令 directory_entry 保持保有默认构造的路径。

参数

p - directory_entry 将指代的文件系统对象的路径
ec - 不抛出重载中报告错误的输出参数

异常

不接受 std::error_code& 参数的重载在底层 OS API 错误时抛出 filesystem_error ,以第一 path 参数 p 和作为错误码参数的 OS 错误码构造。若 OS API 调用失败,则接受 std::error_code& 参数的重载设置该参数为 OS API 错误码,而若不出现错误则执行 ec.clear() 。若内存分配失败,则任何不标记为 noexcept 的重载可能抛出 std::bad_alloc

示例