命名空间
变体
操作

std::filesystem::directory_iterator::directory_iterator

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

                    std::filesystem::directory_options options,

                    std::error_code& ec );
 (5) (since C++17)
directory_iterator( const directory_iterator& other ) = default;
 (6) (since C++17)
directory_iterator( directory_iterator&& other ) = default;
 (7) (since 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) 如果操作系统 API 调用失败，则将 std::error_code& 参数设置为操作系统 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"