Namespaces
Variants

std::filesystem::recursive_directory_iterator:: disable_recursion_pending

From cppreference.net
C++
Filesystem library
Classes
Functions
File types
std::filesystem::recursive_directory_iterator
void disable_recursion_pending ( ) ;
(自 C++17 起)

禁用对当前引用子目录（如果存在）的递归操作。

该调用以这样的方式修改迭代器上的待处理递归标志：使得下一次调用 increment 时，即使迭代器当前指向尚未访问的子目录，它也会在当前目录内前进。

可通过 recursion_pending() 查询待处理递归标志的状态，该调用后将变为 false 。在执行 increment 操作后会被重置为 true ，其初始值同样为 true 。

若 * this 为结束迭代器，则行为未定义。

目录

参数

(无)

返回值

(无)

异常

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

示例

运行此代码 
#include <cstdlib>
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
namespace fs = std::filesystem;
int main()
{
    fs::current_path(fs::temp_directory_path());
    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");
    std::system("tree sandbox");
    for (auto i = fs::recursive_directory_iterator("sandbox");
         i != fs::recursive_directory_iterator();
         ++i)
    {
        std::cout << std::string(i.depth() * 2, ' ') << *i;
        if (fs::is_symlink(i->symlink_status()))
            std::cout << " -> " << fs::read_symlink(*i);
        std::cout << '\n';
        // 不进入 "b" 目录进行递归遍历
        if (i->path().filename() == "b")
            i.disable_recursion_pending();
    }
    fs::remove_all("sandbox");
}

可能的输出： 

sandbox
├── a
│   └── b
│       ├── c
│       ├── d
│       │   └── e
│       └── file1.txt
└── syma -> a
"sandbox/a"
  "sandbox/a/b"
"sandbox/syma" -> "a"

参阅

检查当前目录的递归是否被禁用
(公开成员函数)
前进到下一个条目
(公开成员函数)