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

来自cppreference.com
 
 
实验性
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
实验性非 TS 功能特性
模式匹配
线性代数
std::execution
契约
2D 图形
 
 
 
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