std::filesystem::recursive_directory_iterator::operator++, std::filesystem::recursive_directory_iterator::increment
来自 cppreference.cn
| 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) 在底层 OS API 错误时抛出 std::filesystem::filesystem_error，其构造时将 OS 错误码作为错误码参数。
[编辑] 示例
| 本节不完整 原因：无示例 |
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
|---|---|---|---|
| LWG 3013 | C++17 | error_code 重载被标记为 noexcept 但可以分配内存 |
noexcept 已移除 |
