##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::experimental::filesystem::directory_iterator

From cppreference.com
< cpp‎ | experimental‎ | fs

| Merged into ISO C++ The functionality described on this page was merged into the mainline ISO C++ standard as of 3/2016; see std::filesystem::directory_iterator (since C++17)

Defined in header `<experimental/filesystem>` |  |
class directory_iterator; |  | (filesystem TS)

`directory_iterator` is an `InputIterator` that iterates over the `directory_entry` elements of a directory (but does not visit the subdirectories). The iteration order is unspecified, except that each directory entry is visited only once. The special pathnames dot and dot-dot are skipped.

If the `directory_iterator` is advanced past the last directory entry, it becomes equal to the default-constructed iterator, also known as the end iterator. Two end iterators are always equal, dereferencing or incrementing the end iterator is undefined behavior.

If a file or a directory is deleted or added to the directory tree after the directory iterator has been created, it is unspecified whether the change would be observed through the iterator.

### [edit] Member types

Member type | Definition
`value_type` | `filesystem::directory_entry`
`difference_type` | `std::ptrdiff_t`
`pointer` | `const filesystem::directory_entry*`
`reference` | `const filesystem::directory_entry&`
`iterator_category` | `std::input_iterator_tag`

### [edit] Member functions

(constructor) | constructs a directory iterator (public member function) [edit]
(destructor) | default destructor (public member function) [edit]
operator= | assigns contents (public member function) [edit]
operator*operator-> | accesses the pointed-to entry (public member function) [edit]
increment operator++ | advances to the next entry (public member function) [edit]

### [edit] Non-member functions

filesystem::begin(filesystem::directory_iterator)filesystem::end(filesystem::directory_iterator) | range-based for loop support (function) [edit]

Additionally, `operator==` and `operator!=` are provided, either as members or as non-members, as required by `InputIterator`

### [edit] Example

Run this code

    #include <fstream>
    #include <iostream>
    #include <experimental/filesystem>
    namespace fs = std::experimental::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");
    }

Possible output:

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

### [edit] See also

recursive_directory_iterator | an iterator to the contents of a directory and its subdirectories (class) [edit]
directory_options | options for iterating directory contents (enum) [edit]
directory_entry | a directory entry (class) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/experimental/fs/directory_iterator&oldid=88317"