Manpage  — READDIR

readdir - Liest einen Verzeichniseintrag

ÜBERSICHT BESCHREIBUNG RÜCKGABEWERT FEHLER KONFORM ZU SIEHE AUCH

#include <sys/types.h> 

#include <dirent.h> 

struct dirent *readdir(DIR *dir); 

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> folgendermassen 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 */
};

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.

EBADF	dir ist kein gültiger Zeiger auf eine Verzeichnisdatei.

SVID 3, POSIX, BSD 4.3