CKTIS / C++
std::filesystem::directory_iterator : parcours unique d’un répertoire
std::filesystem::directory_iterator est un itérateur d’entrée sur les entrées immédiates d’un répertoire, sans descente automatique dans les sous-répertoires.
Version : C++23
Syntaxe
class std::filesystem::directory_iterator {
public:
using iterator_category = std::input_iterator_tag;
directory_iterator() noexcept;
explicit directory_iterator(const std::filesystem::path& p);
const std::filesystem::directory_entry& operator*() const;
directory_iterator& operator++();
};std::filesystem::directory_iterator(p) de <filesystem> expose une séquence de directory_entry pour les fichiers directement dans p. Il omet . et .., utilise un ordre non spécifié et son constructeur par défaut crée l’unique valeur de fin valide.
L’exemple crée deux fichiers totalisant trois octets, parcourt sans dépendre de l’ordre et affiche 2 3. C’est un itérateur d’entrée à passage unique : ses copies ne sont pas deux curseurs indépendants et la fin n’est pas déréférençable.
Si le répertoire change pendant le parcours, l’observation des entrées ajoutées ou supprimées est non spécifiée. Un directory_entry peut contenir des attributs en cache et son chemin peut être un lien pendant. Une erreur ou le dépassement du dernier élément place l’itérateur à la fin ; skip_permission_denied peut transformer un refus à la construction en plage vide.
Exemples
#include <cstdint>
#include <filesystem>
#include <fstream>
#include <iostream>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-directory-iterator";
std::error_code ignored;
fs::remove_all(root, ignored);
fs::create_directory(root);
std::ofstream(root / "a.txt") << "x";
std::ofstream(root / "b.txt") << "yz";
int regular_files = 0;
std::uintmax_t bytes = 0;
for (const fs::directory_entry& entry : fs::directory_iterator(root)) {
if (entry.is_regular_file()) {
++regular_files;
bytes += entry.file_size();
}
}
std::cout << regular_files << ' ' << bytes << '\n';
fs::remove_all(root, ignored);
}
Résultat
2 3
std::filesystem::directory_iterator → 2 3