readdir(3C)             (BSD Compatibility Package)             readdir(3C)

NAME
     readdir - Verzeichnisoperation

SYNTAX
     /usr/ucb/cc [flag ...] file ... -lucb

     #include <sys/types.h>
     #include <sys/dir.h>

     struct direct *readdir(DIR *dirp);

BESCHREIBUNG
     readdir gibt einen Zeiger auf den nächsten aktiven Verzeichniseintrag
     zurück und stellt den Verzeichnisstrom auf den nächsten Eintrag. Es
     werden keine aktiven Einträge zurückgegeben. Wenn das Ende des Ver-
     zeichnisses erreicht oder eine ungültige Position im Verzeichnis
     gefunden wird, gibt die Funktion NULL zurück. readdir puffert mehrere
     Verzeichniseinträge pro Leseoperation. Jedesmal, wenn das Verzeichnis
     tatsächlich gelesen wird, markiert readdir das Feld statime des Ver-
     zeichnisses zum Aktualisieren.

DIAGNOSE
     readdir gibt bei einem Fehler NULL zurück und setzt errno auf den fol-
     genden Wert:

     ENOENT    Der aktuelle Dateizeiger für das Verzeichnis weist nicht auf
               einen gültigen Eintrag. Der Strom wurde geschlossen.

BEISPIELE
     Es folgt ein Beispielprogramm, das die Namen aller Dateien im aktuel-
     len Verzeichnis ausgibt:

     #include <sys/types.h>
     #include <sys/dir.h>

     main()
     {
          DIR     *p;

          struct direct   *de;
          int     status = 0;

          if ((p =opendir (".")) == NULL ) {
             perror("opendir");
             exit(1);
          }
          while (de = readdir(p)) {
             printf("%s\n", de->dname);
          }
          exit(status);
     }




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

readdir(3C)             (BSD Compatibility Package)             readdir(3C)

SIEHE AUCH
     directory(3C), direct(4).




















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98