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