readdir - read a directory
SYNOPSIS
#include <sys/types.h>
#include <dirent.h>
struct dirent *readdir(DIR *dir);
DESCRIPTION
The readdir() function returns a pointer to a dirent
structure representing the next directory entry in the
directory stream pointed to by dir. It returns NULL on
reaching the end-of-file or if an error occurred.
The data returned by readdir() is overwritten by subse
quent calls to readdir() for the same directory stream.
According to POSIX, the dirent structure contains a field
char d_name[] of unspecified size, with at most NAME_MAX
characters preceding the terminating null character. Use
of other fields will harm the portability of your pro
grams.
RETURN VALUE
The readdir() function returns a pointer to a dirent
structure, or NULL if an error occurs or end-of-file is
reached.
ERRORS
EBADF Invalid directory stream descriptor dir.
CONFORMING TO
SVID 3, POSIX, BSD 4.3
SEE ALSO
read(2), opendir(3), closedir(3), rewinddir(3),
seekdir(3), telldir(3), scandir(3)
Man(1) output converted with
man2html