NOMBRE

       readdir - lee un directorio

SINOPSIS

       #include <sys/types.h>

       #include <dirent.h>

       struct dirent *readdir(DIR *dir);

DESCRIPCIÓN

       La  función  readdir() devuelve un puntero a una estructura dirent que representa la siguiente entrada de
       directorio en el flujo de directorio al que apunte dir.  Devuelve NULL cuando alcanza el fin-de-fichero o
       si hay un error.

       Según POSIX, la estructura dirent contiene un campo char d_name[] de tamaño no especificado, con NAME_MAX
       caracteres como mucho precediendo al carácter cero terminador.  El empleo de otros campos perjudicará  la
       transportabilidad  de  sus  programas.   En  POSIX-2001  también  aparece  el  campo ino_t d_ino como una
       extensión de XSI.

       Los datos devueltos por readdir() pueden ser sobreescritos por llamadas posteriores a readdir()  para  el
       mismo flujo de directorio.

VALOR DEVUELTO

       La  función readdir() devuelve un puntero a una estructura dirent, o NULL si ocurre un error o se alcanza
       el fin-de-fichero.

ERRORES

       EBADF  Descriptor de flujo de directorio inválido dir.

CONFORME A

       SVID 3, POSIX, BSD 4.3

VÉASE TAMBIÉN

       read(2), closedir(3), dirfd(3), opendir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)