STD::FILESYSTEM_PATH_ITERATOR(3)

💅 std::filesystem::path::iterator — from the libstdc++ manual, bestie

okay so picture this: you're deep in std::filesystem and you need to walk a path piece by piece, like component by component, and you're out here thinking "surely there's a whole iterator for that." There is. It lives in libstdc++ and it's literally called std::filesystem::path::iterator. An iterator for the components of a path. That's the whole vibe. 🦋

---

✨ NAME ✨

std::filesystem::path::iterator — an iterator for the components of a path. That's it. That's the gig. 💖

---

🎀 SYNOPSIS 🎀

🌸 Public Types

these are the type aliases it's serving, and you will respect them:

• difference_type — using difference_type = std::ptrdiff_t
• iterator_category — using iterator_category = std::bidirectional_iterator_tag (so yes bestie, it goes both ways 👑)
• pointer — using pointer = const path *
• reference — using reference = const path &
• value_type — using value_type = path

⭐ Public Member Functions

every single one, no skipping, iykyk:

• iterator (const iterator &)=default — copy constructor, defaulted, doing exactly what it says on the tin
• reference operator* () const — dereference it, get your reference back
• iterator & operator++ () — prefix increment, returns a reference to this iterator
• iterator operator++ (int) — postfix increment, returns a copy
• iterator & operator-- () — prefix decrement, same deal, returns a reference
• iterator operator-- (int) — postfix decrement, returns a copy
• pointer operator-> () const — arrow operator, hands you a pointer
• iterator & operator= (const iterator &)=default — copy assignment, defaulted, slay

🫶 Friends

these aren't just friends, they're friends-of-the-class friends:

void __path_iter_advance (iterator &__i, difference_type __n)
difference_type __path_iter_distance (const iterator &__first, const iterator &__last)
bool operator!= (const iterator &__lhs, const iterator &__rhs)
bool operator== (const iterator &__lhs, const iterator &__rhs)
class path

• void __path_iter_advance (iterator &__i, difference_type __n) — advances __i by __n
• difference_type __path_iter_distance (const iterator &__first, const iterator &__last) — the distance between __first and __last
• bool operator!= (const iterator &__lhs, const iterator &__rhs) — inequality check between two iterators
• bool operator== (const iterator &__lhs, const iterator &__rhs) — equality check between two iterators
• class path — the class being friended, obviously, it's right there in the name of the whole thing 💀

---

🧚 Detailed Description 🧚

An iterator for the components of a path. Fr fr. You point it at a path, you increment it, and it walks you through the components one at a time like it's reading your horoscope. Highkey iconic.

ngl there's not a ton more in this doc — what you see is what you get, and what you get is a bidirectional iterator over path components. no cap.

---

🔥 Author 🔥

Generated automatically by Doxygen for libstdc++ from the source code. Not a human, not a vibe, just Doxygen doing its little thing. 🙈

---

kisses bestie, this page was brought to you by libstdc++ and it was dated Wed Oct 7 2026 — go forth and iterate, mwah 💋