命名空间
变体
操作

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

来自 cppreference.cn
 
 
 
 
定义于头文件 <filesystem>
directory_iterator begin( directory_iterator iter ) noexcept;
(1) (自 C++17 起)
directory_iterator end( directory_iterator ) noexcept;
(2) (自 C++17 起)
1) 返回未更改的 iter
2) 返回默认构造的 directory_iterator,它充当末尾迭代器。实参被忽略。

这些非成员函数启用将 directory_iterator 与基于范围的 for 循环一同使用 并使 directory_iterator 成为 range 类型(自 C++20 起)

目录

[edit] 参数

iter - 一个 directory_iterator

[edit] 返回值

1) 未更改的 iter
2) 末尾迭代器(默认构造的 directory_iterator)。

[edit] 示例

#include <filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::filesystem;
 
int main()
{
    fs::create_directories("sandbox/a/b");
    std::ofstream("sandbox/file1.txt");
    std::ofstream("sandbox/file2.txt");
    for (auto& p : fs::directory_iterator("sandbox"))
        std::cout << p << '\n';
    fs::remove_all("sandbox");
}

可能的输出

"sandbox/a"
"sandbox/file1.txt"
"sandbox/file2.txt"

[edit] 缺陷报告

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

DR 应用于 发布时的行为 正确的行为
LWG 3480 C++17 end 按引用取得实参 按值取得实参

[edit] 参见

基于范围的 for 循环支持
(函数) [编辑]