命名空间
变体
操作

std::filesystem::directory_iterator::directory_iterator

来自 cppreference.cn
 
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 - 控制目录迭代器行为的 位掩码类型 选项集
其他 - 另一个目录迭代器，用作初始化目录迭代器的源

[编辑] 异常

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

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

[编辑] 注意

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

[编辑] 示例

本节不完整
原因：无示例

[编辑] 缺陷报告

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

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