REWINDDIR(3P)

💫 REWINDDIR(3P) 💫

okay bestie, welcome to the POSIX Programmer's Manual entry for rewinddir, page 3P 🎀 this one's short and sweet but it's important, so let's get into it.

---

🦋 PROLOG 🦋

so like, real talk first: this manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (go check the corresponding Linux manual page for the tea on Linux behavior, fr), or the interface might not even be implemented on Linux at all. 💀

---

✨ NAME ✨

rewinddir — reset the position of a directory stream to the beginning of a directory

---

🌸 SYNOPSIS 🌸

#include <dirent.h>

void rewinddir(DIR *dirp);

---

💖 DESCRIPTION 💖

okay so here's the whole vibe. The rewinddir() function shall reset the position of the directory stream to which dirp refers to the beginning of the directory. That's it, that's the job. 🫶

AND — iconic bonus feature — it shall also cause the directory stream to refer to the current state of the corresponding directory, exactly like a call to opendir() would have done. so it's not just a rewind, it's a glow-up. ✨

⚠️ but bestie listen: if dirp does not refer to a directory stream, the effect is undefined. no cap. don't do that.

And after a call to the fork() function, either the parent or the child (but not both) may continue processing the directory stream using readdir(), rewinddir(), or seekdir(). If both the parent and child processes use these functions, the result is undefined. pick a lane, one of you. 💅

---

🌈 RETURN VALUE 🌈

The rewinddir() function shall not return a value. it's a void girlie, she gives nothing back and that's the point.

---

🍓 ERRORS 🍓

No errors are defined.

The following sections are informative. (translation: the rest is bonus content, not the rules 👑)

---

🎀 EXAMPLES 🎀

None. 😭 truly nothing here, move along.

---

🧚 APPLICATION USAGE 🧚

The rewinddir() function should be used in conjunction with opendir(), readdir(), and closedir() to examine the contents of the directory. This method is recommended for portability. so like, use the squad together, not solo. main character energy requires a supporting cast. 💜

---

⭐ RATIONALE ⭐

None.

---

🔥 FUTURE DIRECTIONS 🔥

None.

---

👑 SEE ALSO 👑

• closedir()
• fdopendir()
• readdir()

The Base Definitions volume of POSIX.1‐2017, <dirent.h>, <sys_types.h>

---

💅 COPYRIGHT 💅

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

---

and that's the whole page bestie!! 💖 this one came to you courtesy of IEEE/The Open Group, dated 2017, and the page itself is REWINDDIR(3P). slay, go rewind that directory. 🦋✨