命名空间
变体
操作

std::filesystem::begin(recursive_directory_iterator), std::filesystem::end(recursive_directory_iterator)

来自 cppreference.com
 
C++
 
文件系统库
类
函数
文件类型
 
std::filesystem::recursive_directory_iterator
 
定义在头文件 <filesystem> 中
recursive_directory_iterator begin( recursive_directory_iterator iter ) noexcept;
 (1) (自 C++17 起)
recursive_directory_iterator end( recursive_directory_iterator ) noexcept;
 (2) (自 C++17 起)
1) 返回 iter 不变。
2) 返回一个默认构造的 recursive_directory_iterator，它作为结束迭代器。参数被忽略。

这些非成员函数使 recursive_directory_iterators 能够用于基于范围的 for 循环并使 recursive_directory_iterator 成为 范围 类型(自 C++20 起).

内容

[编辑] 参数

iter - 一个 recursive_directory_iterator

[编辑] 返回值

1) iter 不变。
2) 结束迭代器 (默认构造的 recursive_directory_iterator)。

[编辑] 示例

运行这段代码
#include <cstdlib>
#include <filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::filesystem;
 
int main()
{
    fs::current_path(fs::temp_directory_path());
    fs::create_directories("sandbox/a/b");
    std::ofstream("sandbox/file1.txt");
    fs::create_symlink("a", "sandbox/syma");
 
    std::cout << "Print dir structure using OS specific command 'tree':\n";
    std::system("tree --noreport sandbox");
 
    std::cout << "\nPrint dir structure using directory iterator:\n";
    for (auto& p : fs::recursive_directory_iterator("sandbox"))
        std::cout << p << '\n';
 
    fs::remove_all("sandbox");
}

可能的输出

Print dir structure using OS specific command 'tree':
sandbox
├── a
│   └── b
├── file1.txt
└── syma -> a
 
Print dir structure using directory iterator:
"sandbox/syma"
"sandbox/file1.txt"
"sandbox/a"
"sandbox/a/b"

[编辑] 缺陷报告

以下行为变更缺陷报告已追溯应用于先前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 3480 C++17 end 通过引用获取参数 通过值获取参数

[编辑] 参见

(C++17)
 基于范围的 for 循环支持
(函数) [编辑]
检索自 "https://cppreference.cn/mwiki/index.php?title=cpp/filesystem/recursive_directory_iterator/begin&oldid=158510"