std::filesystem::beginstd::filesystem::end
From cppreference.com
ヘッダー <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を返します。これは終端イテレータとして機能します。引数は無視されます。
これらの非メンバ関数は、範囲ベースforループでrecursive_directory_iteratorを使用できるようにし、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 << "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は引数を参照で受け取っていた引数を値で受け取る
[編集] 関連項目
範囲ベース for ループのサポート
(function)
| ヘッダー <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を返します。これは終端イテレータとして機能します。引数は無視されます。
これらの非メンバ関数は、範囲ベースforループでrecursive_directory_iteratorを使用できるようにし、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 << "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は引数を参照で受け取っていた |
引数を値で受け取る |
[編集] 関連項目
| 範囲ベース for ループのサポート (function) |
