Provided by:
manpages-de-dev_0.5-4.1ubuntu1_all 
BEZEICHNUNG
readdir - Liest einen Verzeichniseintrag
ÜBERSICHT
#include <sys/types.h>
#include <dirent.h>
struct dirent *readdir(DIR *dir);
BESCHREIBUNG
Die readdir()-Funktion liefert einen Zeiger auf eine dirent-Struktur
zurück, welcher auf den nächsten Verzeichniseintrag zeigt. Dir muss
dabei auf eine Verzeichnisdatei ("directory stream") zeigen. Wenn das
Dateiende erreicht wurde oder ein Fehler auftrat, dann wird ein NULL-
Zeiger zurückgeliefert.
Wird readdir() mehrfach für ein Verzeichnis aufgerufen, dann
überschreiben die nachfolgenden Aufrufe die Daten, die von den vorigen
readdir()-Aufrufen zurückgeliefert wurden.
Die dirent-Struktur ist in <linux/dirent.h> folgendermaßen definiert:
struct dirent {
long d_ino; /* Inode Nummer */
off_t d_off; /* Offset zum nächsten dirent */
unsigned short d_reclen;/* Länge dieses Eintrags */
char d_name[NAME_MAX+1]; /* Dateiname */
};
RÜCKGABEWERT
Die readdir()-Funktion liefert einen Zeiger auf eine dirent-Struktur
zurück. Wenn das Dateiende erreicht wurde oder ein Fehler auftrat,
dann wird ein NULL-Zeiger zurückgeliefert.
FEHLER
EBADF dir ist kein gültiger Zeiger auf eine Verzeichnisdatei.
KONFORM ZU
SVID 3, POSIX, BSD 4.3
SIEHE AUCH
read(2), opendir(3), closedir(3), rewinddir(3), seekdir(3), telldir(3),
scandir(3).
31. Mai 1996 READDIR(3)