Namespaces
Variants

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

From cppreference.net
C++
Filesystem library
Classes
Functions
File types
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_iterator 能够与基于范围的for循环一起使用 ，并将 recursive_directory_iterator 转换为 range 类型 (自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 << "使用操作系统特定命令 'tree' 打印目录结构：\n";
    std::system("tree --noreport sandbox");
    std::cout << "\n使用目录迭代器打印目录结构：\n";
    for (auto& p : fs::recursive_directory_iterator("sandbox"))
        std::cout << p << '\n';
    fs::remove_all("sandbox");
}

可能的输出： 

使用操作系统特定命令 'tree' 打印目录结构：
sandbox
├── a
│   └── b
├── file1.txt
└── syma -> a
使用目录迭代器打印目录结构：
"sandbox/syma"
"sandbox/file1.txt"
"sandbox/a"
"sandbox/a/b"

缺陷报告

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

缺陷报告 适用范围 发布时行为 正确行为
LWG 3480 C++17 end 通过引用接收参数 通过值接收参数

参见

(C++17)
基于范围的 for 循环支持
(函数)