Available in

(2) (3) (2)/de (3)/de (2)/es (3)/es (2)/fr (3)/fr (2)/ja (3)/ja (2)/ko (3)/ko (2)/nl (2)/pl (2)/pt (3)/pt

Contents

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).

COMMENTS

blog comments powered by Disqus