std::files...tory_entry(3)

💅 std::files...tory_entry(3) — Library Functions Manual, straight outta libstdc++

okay so bestie, welcome to the glow-up of your filesystem era ✨ this one's a C++ manpage from libstdc++ (yes, the Library Functions Manual one) and honestly? she's an icon. let's get into it 🎀

---

🌸 NAME

std::filesystem::directory_entry — the value type used by directory iterators. that's literally the whole description and she's serving main character energy with it 💅

---

✨ SYNOPSIS ✨

🫶 Public Member Functions

• directory_entry (const directory_entry &)=default — the copy constructor, and it's defaulted. no cap, the compiler is doing the work for you 🫶
• directory_entry (const filesystem::path &__p) — make a fresh one from a const filesystem::path &__p.
• directory_entry (const filesystem::path &__p, error_code &__ec) — same path vibe, but you also hand over an error_code &__ec.
• directory_entry (directory_entry &&) noexcept=default — the move constructor, noexcept and defaulted. move like a queen 🦋
• void assign (const filesystem::path &__p) — reassign this entry to __p.
• void assign (const filesystem::path &__p, error_code &__ec) — same thing, plus an error_code &__ec slot for you.
• bool exists () const — the existence check, returns bool, const. simple. iconic.
• bool exists (error_code &__ec) const noexcept — the existence check again but with error_code &__ec, and this one's noexcept 💖
• uintmax_t file_size () const — file size, returns uintmax_t, const.
• uintmax_t file_size (error_code &__ec) const noexcept — file size with error_code &__ec and noexcept.
• uintmax_t hard_link_count () const — hard link count, uintmax_t, const.
• uintmax_t hard_link_count (error_code &__ec) const noexcept — hard link count with error_code &__ec, noexcept.
• bool is_block_file () const — block file? bool. const.
• bool is_block_file (error_code &__ec) const noexcept — block file, error_code &__ec edition, noexcept.
• bool is_character_file () const — character file? bool. const.
• bool is_character_file (error_code &__ec) const noexcept — character file, error_code &__ec edition, noexcept.
• bool is_directory () const — the directory question, answered in bool, const.
• bool is_directory (error_code &__ec) const noexcept — directory question with error_code &__ec, noexcept.
• bool is_fifo () const — fifo check, bool, const.
• bool is_fifo (error_code &__ec) const noexcept — fifo check with error_code &__ec, noexcept.
• bool is_other () const — the "other" check, bool, const. mysterious. love that for her 🕵️
• bool is_other (error_code &__ec) const noexcept — "other" check with error_code &__ec, noexcept.
• bool is_regular_file () const — regular file check, bool, const.
• bool is_regular_file (error_code &__ec) const noexcept — regular file check with error_code &__ec, noexcept.
• bool is_socket () const — socket check, bool, const.
• bool is_socket (error_code &__ec) const noexcept — socket check with error_code &__ec, noexcept.
• bool is_symlink () const — symlink check, bool, const.
• bool is_symlink (error_code &__ec) const noexcept — symlink check with error_code &__ec, noexcept.
• file_time_type last_write_time () const — last write time, returns file_time_type, const.
• file_time_type last_write_time (error_code &__ec) const noexcept — last write time with error_code &__ec, noexcept.
• operator const filesystem::path & () const noexcept — a conversion to const filesystem::path &, and it's noexcept. she converts ✨
• bool operator!= (const directory_entry &__rhs) const noexcept — not-equal against const directory_entry &__rhs, bool, const, noexcept.
• bool operator< (const directory_entry &__rhs) const noexcept — less-than against __rhs, bool, const, noexcept.
• bool operator<= (const directory_entry &__rhs) const noexcept — less-or-equal against __rhs, bool, const, noexcept.
• directory_entry & operator= (const directory_entry &)=default — copy assignment, returns directory_entry &, defaulted 🫶
• directory_entry & operator= (directory_entry &&) noexcept=default — move assignment, returns directory_entry &, noexcept, defaulted. ate 💅
• bool operator== (const directory_entry &__rhs) const noexcept — equality against __rhs, bool, const, noexcept.
• bool operator> (const directory_entry &__rhs) const noexcept — greater-than against __rhs, bool, const, noexcept.
• bool operator>= (const directory_entry &__rhs) const noexcept — greater-or-equal against __rhs, bool, const, noexcept.
• const filesystem::path & path () const noexcept — hands you back a const filesystem::path &, const, noexcept. the way she just gives you the path 😭
• void refresh () — refreshes. void, no args.
• void refresh (error_code &__ec) noexcept — refreshes, takes error_code &__ec, and it's noexcept.
• void replace_filename (const filesystem::path &__p) — swaps in a new filename from __p.
• void replace_filename (const filesystem::path &__p, error_code &__ec) — same, with an error_code &__ec alongside.
• file_status status () const — returns file_status, const.
• file_status status (error_code &__ec) const noexcept — returns file_status, with error_code &__ec, noexcept.
• file_status symlink_status () const — returns file_status for symlink status, const.
• file_status symlink_status (error_code &__ec) const noexcept — symlink status with error_code &__ec, noexcept.

not me noticing the pattern: the error_code &__ec overloads all snagged noexcept while the no-arg ones didn't. iykyk 👀 that's just what the page says, so that's what we're saying.

👯 Friends

• struct _Dir — a friend struct, underscore-and-all. very private, very exclusive 🌈
• class directory_iterator — friend class. this whole page literally exists for her 💖
• template<typename _CharT , typename _Traits > basic_ostream< _CharT, _Traits > & operator<< (basic_ostream< _CharT, _Traits > &__os, const directory_entry &__d) — the stream insertion operator, fully templated on _CharT and _Traits, taking __os and __d, returning basic_ostream< _CharT, _Traits > &. verbatim bestie, copying it exactly 🎀
• class recursive_directory_iterator — friend class too, the recursive one 🌀

---

🦋 Detailed Description

The value type used by directory iterators.

that's it. that's the whole description. short, sweet, absolutely slaying, no notes 💅

---

🧚 Author

Generated automatically by Doxygen for libstdc++ from the source code. — no human wrote this, a robot did, and she still ate 🔥

---

okay bestie that's the whole page, every single flag-signature-thing intact, no skips, no cap 🌸 this was libstdc++, dated Wed Oct 7 2026, filed under std::files...tory_entry(3). go forth and iterate directories, you gorgeous genius 🫶✨🎀