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

recursive_directory_iterator& operator++();
(文件系统 TS)
recursive_directory_iterator& increment( error_code& ec );
(文件系统 TS)

推进迭代器到下一个目录项。

如果当前迭代的目录中没有更多的剩余目录项,则继续其父目录上的迭代。如果父目录没有可以迭代的同级目录项则重复此处理。如果抵达了目录层次中已被递归迭代的父目录(depth() == 0) 处没有其他候选目录项),则设置 *this 为尾迭代器。

否则,如果 *this 指代目录,则当满足如下条件时迭代进入其中:

  • 此次自增前尚未调用 disable_recursion_pending(),亦即 recursion_pending() == true
  • 目录不是符号链接或启用了跟随符号链接,亦即
!is_symlink(this->symlink_status()) ||
    (options() & directory_options::follow_directory_symlink) != 0)

参数

ec - 存储错误状态的错误码

返回值

*this

异常

1) 当发生错误时抛出 filesystem_error。错误码被设置为对于造成此错误适当的错误码。
2)
noexcept 规定:  
noexcept