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)