rewinddir()--Reset Directory Stream to Beginning

 #include <sys/types.h>
 #include <dirent.h>

 void rewinddir(DIR *dirp);  

The rewinddir() function "rewinds" the position of an open directory stream to the beginning. dirp points to a DIR associated with an open directory stream.

The next call to readdir() reads the first entry in the directory. If the contents of the directory have changed since the directory was opened and rewinddir() is called, subsequent calls to readdir() read the changed contents.

Parameters

dirp

(Input) A pointer to a DIR that refers to the open directory stream to be rewound. This pointer is returned by the opendir() function.

Authorities

No authorization is required. Authorization is verified during opendir().

Return Value

None.

Error Conditions

None.

Error Messages

The following messages may be sent from this function:

Usage Notes

1. If the dirp argument passed to rewinddir() does not refer to an open directory, unexpected results could occur.
   
2. Files that are added to the directory after opendir() or rewinddir() may not be returned on calls to readdir().

Related Information

• The <sys/types.h> file (see Header Files for UNIX-Type Functions)
  
• The <dirent.h> file (see Header Files for UNIX-Type Functions)
  
• opendir()--Open Directory
  
• readdir()--Read Directory Entry
  
• closedir()--Close Directory

Example

See Code disclaimer information for information pertaining to code examples.

The following example produces the contents of a directory by opening it, rewinding it, and closing it:

#include <sys/types.h>
#include <dirent.h>
#include <errno.h>
#include <stdio.h>

main() {
  DIR *dir;
  struct dirent *entry;

  if ((dir = opendir("/")) == NULL)
    perror("opendir() error");
  else {
    puts("contents of root:");
    while ((entry = readdir(dir)) != NULL)
      printf("%s ", entry->d_name);
    rewinddir(dir);
    puts("");
    while ((entry = readdir(dir)) != NULL)
      printf("%s ", entry->d_name);
    closedir(dir);
    puts("");
  }
}

Output:

contents of root:
  . .. QSYS.LIB QDLS QOpenSys QOPT home
  . .. QSYS.LIB QDLS QOpenSys QOPT home newdir