Rechercher une page de manuel

Chercher une autre page de manuel:

readdir

Autres langues

Langue: de

Version: 31. Mai 1996 (openSuse - 09/10/07)

Autres sections - même nom

Section: 3 (Bibliothèques de fonctions)

Sommaire

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).
Ce n'est pas la ciguë, c'est le syllogisme qui tue Socrate.
-+- Paul Valéry -+-