std::filesystem::recursive_directory_iterator::operator++, std::filesystem::recursive_directory_iterator::increment

recursive_directory_iterator& operator++();	(1)	(自 C++17 起)
recursive_directory_iterator& increment( std::error_code& ec );	(2)	(自 C++17 起)

将迭代器前进到下一个条目。使先前 *this 值的所有副本失效。

如果当前正在迭代的目录中没有更多条目，则迭代将从父目录继续。如果父目录没有可以迭代的兄弟条目，则重复此过程。如果递归迭代的目录层次结构的父级到达（在 depth() == 0) 处没有候选条目），则 *this 将设置为结束迭代器。

否则，如果 *this 指向目录，则如果满足以下条件，则会将其迭代到：

disable_recursion_pending() 在此增量之前未调用过，即 recursion_pending() == true。
该目录不是符号链接，或者已启用跟随符号链接，即以下至少一个条件为真：
- !is_symlink((*this)->symlink_status()).
- (options() & directory_options::follow_directory_symlink) != directory_options::none)

内容

ec

-

用于存储错误状态的错误代码

*this

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

1) 在底层操作系统 API 错误上抛出 std::filesystem::filesystem_error，使用操作系统错误代码作为错误代码参数构造。

2) 如果操作系统 API 调用失败，则将 std::error_code& 参数设置为操作系统 API 错误代码，如果未发生错误，则执行 ec.clear()。

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

DR	应用于	发布的行为	正确行为
LWG 3013	C++17	`error_code` 重载标记为 noexcept，但可以分配内存	noexcept 已删除

成员函数
recursive_directory_iterator::recursive_directory_iterator
recursive_directory_iterator::operator*recursive_directory_iterator::operator->
recursive_directory_iterator::options
recursive_directory_iterator::depth
recursive_directory_iterator::recursion_pending
recursive_directory_iterator::operator=
recursive_directory_iterator::incrementrecursive_directory_iterator::operator++
recursive_directory_iterator::pop
recursive_directory_iterator::disable_recursion_pending
非成员函数
begin(std::filesystem::recursive_directory_iterator)end(std::filesystem::recursive_directory_iterator)