std::filesystem::beginstd::filesystem::end
From cppreference.com
< cpp | filesystem | directory iterator
ヘッダー <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を返します。これは終端イテレータとして機能します。引数は無視されます。
これらの非メンバ関数により、範囲ベースforループでdirectory_iteratorを使用できるようになります。また、directory_iteratorをrange型にします(C++20以降)。
目次
[編集] パラメータ
iter
-
directory_iterator
[編集] 戻り値
1) iterをそのまま返します。
2) 終端イテレータ（デフォルト構築されたdirectory_iterator）。
[編集] 例
このコードを実行
#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"
[編集] 不具合報告
以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。
DR
適用対象
公開された動作
正しい動作
LWG 3480
C++17
end は引数を参照で受け取っていました引数を値で受け取ります
[編集] 関連項目
範囲ベース for ループのサポート
(関数)
| ヘッダー <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を返します。これは終端イテレータとして機能します。引数は無視されます。
これらの非メンバ関数により、範囲ベースforループでdirectory_iteratorを使用できるようになります。また、directory_iteratorをrange型にします(C++20以降)。
目次 |
[編集] パラメータ
| iter | - | directory_iterator |
[編集] 戻り値
1) iterをそのまま返します。
2) 終端イテレータ（デフォルト構築された
directory_iterator）。[編集] 例
このコードを実行
#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"
[編集] 不具合報告
以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。
| DR | 適用対象 | 公開された動作 | 正しい動作 |
|---|---|---|---|
| LWG 3480 | C++17 | end は引数を参照で受け取っていました |
引数を値で受け取ります |
[編集] 関連項目
| 範囲ベース for ループのサポート (関数) |
