std::filesystem:: begin (recursive_directory_iterator) , std::filesystem:: end (recursive_directory_iterator)
From cppreference.net
<
cpp
|
filesystem
|
recursive directory iterator
|
Definiert im Header
<filesystem>
|
||
|
recursive_directory_iterator begin
(
recursive_directory_iterator iter
)
noexcept
;
|
(1) | (seit C++17) |
|
recursive_directory_iterator end
(
recursive_directory_iterator
)
noexcept
;
|
(2) | (seit C++17) |
1)
Gibt
iter
unverändert zurück.
2)
Gibt einen standardkonstruierten
recursive_directory_iterator
zurück, der als End-Iterator dient. Das Argument wird ignoriert.
Diese Nicht-Mitgliedsfunktionen ermöglichen die Verwendung von
recursive_directory_iterator
s mit bereichsbasierten for-Schleifen
und machen
recursive_directory_iterator
zu einem
range
-Typ
(seit C++20)
.
Inhaltsverzeichnis |
Parameter
| iter | - |
ein
recursive_directory_iterator
|
Rückgabewert
1)
iter
unverändert.
2)
End-Iterator (standardmäßig konstruierter
recursive_directory_iterator
).
Beispiel
Diesen Code ausführen
#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"); }
Mögliche Ausgabe:
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"
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrektes Verhalten |
|---|---|---|---|
| LWG 3480 | C++17 |
end
nahm das Argument als Referenz
|
nimmt das Argument als Wert |
Siehe auch
|
Unterstützung für bereichsbasierte for-Schleifen
(Funktion) |