std::experimental::filesystem::recursive_directory_iterator::disable_recursion_pending

来自cppreference.com
 
C++
 
实验性
技术规范
文件系统库 (文件系统 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
 
void disable_recursion_pending();
(文件系统 TS)

禁止递归到当前指代的子目录，如果有。

此调用修改迭代器上的待定递归标记，使得当调用下一次自增时，迭代器将在当前目录中推进，即便当前它指代尚未访问的子目录也是如此。

待定递归标记的状态可以由 recursion_pending() 查询，此调用后它将为 false。自增之后，它即被重置为 true，且其初始值也是 true。

如果 *this 是尾迭代器则其行为未定义。

参数

（无）

返回值

（无）

异常

可能会抛出由实现定义的异常。

示例

运行此代码
#include <experimental/filesystem>
#include <fstream>
#include <iostream>
#include <string>
namespace fs = std::experimental::filesystem;

int main()
{
    fs::create_directories("sandbox/a/b/c");
    fs::create_directories("sandbox/a/b/d/e");
    std::ofstream("sandbox/a/b/file1.txt");
    fs::create_symlink("a", "sandbox/syma");
    for (auto i = fs::recursive_directory_iterator("sandbox");
             i != fs::recursive_directory_iterator(); ++i)
    {
        std::cout << std::string(i.depth(), ' ') << *i;
        if (fs::is_symlink(i->symlink_status()))
            std::cout << " -> " << fs::read_symlink(*i);
        std::cout << '\n';

        // do not descend into "b"
        if (i->path().filename() == "b")
            i.disable_recursion_pending();
    }
    fs::remove_all("sandbox");
}

输出： 

"sandbox/a"
 "sandbox/a/b"
"sandbox/syma" -> "a"

参阅

 检查是否对当前目录禁用了递归
(公开成员函数)
推进到下一个目录项
(公开成员函数)