命名空间
变体
操作

std::filesystem::directory_iterator::directory_iterator

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

                    std::filesystem::directory_options options,

                    std::error_code& ec );
 (5) (自 C++17 起)
directory_iterator( const directory_iterator& other ) = default;
 (6) (自 C++17 起)
directory_iterator( directory_iterator&& other ) = default;
 (7) (自 C++17 起)

构造一个新的目录迭代器。

1) 构造结束迭代器。
2) 构造一个目录迭代器，它引用由 p标识的目录的第一个目录项。如果 p引用一个不存在的文件或不是目录，则抛出 std::filesystem::filesystem_error.
3) 与 (2)相同，但如果在 options中设置了 std::filesystem::directory_options::skip_permission_denied，并且构造遇到权限被拒绝错误，则构造结束迭代器，并且不报告错误。
4) 构造一个目录迭代器，它引用由 p标识的目录的第一个目录项。如果 p引用一个不存在的文件或不是目录，则返回结束迭代器并设置 ec。
5) 与 (4)相同，但如果在 options中设置了 std::filesystem::directory_options::skip_permission_denied，并且构造遇到权限被拒绝错误，则构造结束迭代器，并且不报告错误。
6) 复制构造函数。
7) 移动构造函数。

内容

[编辑] 参数

p - 指向文件系统对象的路径，目录迭代器将引用该对象
ec - 在非抛出重载中用于错误报告的输出参数
options - 控制目录迭代器行为的 BitmaskType 选项集
other - 另一个目录迭代器，用作初始化目录迭代器的源

[编辑] 异常

任何未标记为 noexcept 的重载都可能抛出 std::bad_alloc，如果内存分配失败。

2,3) 在底层操作系统 API 错误上抛出 std::filesystem::filesystem_error，使用 p 作为第一个路径参数，并使用操作系统错误代码作为错误代码参数构造。
4,5) 将 std::error_code& 参数设置为操作系统 API 错误代码（如果操作系统 API 调用失败），并在没有错误发生时执行 ec.clear()。

[编辑] 备注

要迭代当前目录，将迭代器构造为 directory_iterator(".")，而不是 directory_iterator("")。

[编辑] 示例

本节不完整
原因：没有示例

[编辑] 缺陷报告

以下行为更改的缺陷报告已追溯应用于之前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 3013 C++17 error_code 重载标记为 noexcept 但可以分配内存 已移除 noexcept
检索自 "https://cppreference.cn/mwiki/index.php?title=cpp/filesystem/directory_iterator/directory_iterator&oldid=158173"