std::filesystem::recursive_directory_iterator::recursive_directory_iterator

来自cppreference.com
 
C++
 
文件系统库
类
函数
文件类型
 
std::filesystem::recursive_directory_iterator
 
recursive_directory_iterator() noexcept;
(1)(C++17 起)
recursive_directory_iterator( const recursive_directory_iterator& other );
(2)(C++17 起)
recursive_directory_iterator( recursive_directory_iterator&& other ) noexcept;
(3)(C++17 起)
explicit recursive_directory_iterator( const std::filesystem::path& p );
(4)(C++17 起)
recursive_directory_iterator(

    const std::filesystem::path& p,

    std::filesystem::directory_options options );
(5)(C++17 起)
recursive_directory_iterator(

    const std::filesystem::path& p,
    std::filesystem::directory_options options,

    std::error_code& ec );
(6)(C++17 起)
recursive_directory_iterator( const std::filesystem::path& p, std::error_code& ec );
(7)(C++17 起)

构造新的递归目录迭代器。

1) 默认构造函数。构造尾迭代器。
2) 复制构造函数。
3) 移动构造函数。
4-7) 构造代表 p 所解析到的目录的首个条目的迭代器。
本节未完成
原因：错误

参数

rhs-要复制或移动的迭代器
p-要迭代于其上，及递归地迭代于其子目录上的路径
options-迭代所用的目录选项
ec-存储错误状态的错误码

异常

若内存分配失败，则任何不标记为 noexcept 的重载可能抛出 std::bad_alloc 。

4,5) 抛出 std::filesystem::filesystem_error，构造时以 p 为第一路径实参并以OS 错误码为错误码实参。
6,7) 若 OS API 调用失败，则设置 std::error_code& 为 OS API 错误码，而未发生错误时则执行 ec.clear()。

注解

递归目录迭代器默认不允许跟随目录符号链接。欲启用此行为，须在 options 选项集中指定 directory_options::follow_directory_symlink。

示例

本节未完成
原因：暂无示例

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告应用于出版时的行为正确行为
LWG 3013C++17error_code 重载被标记为 noexcept 但能分配内存移除 noexcept
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/filesystem/recursive_directory_iterator/recursive_directory_iterator&oldid=84056”