READDIR(3)         Manuel du programmeur Linux         READDIR(3)


NOM
       readdir - Consulter un répertoire.

SYNOPSIS
       #include <sys/types.h>

       #include <dirent.h>

       struct dirent *readdir (DIR *dir);

DESCRIPTION
       La  fonction  readdir() renvoie un pointeur sur une struc­
       ture dirent représentant l'entrée suivante du flux  réper­
       toire pointé par dir. Elle renvoie NULL a la fin du réper­
       toire, ou en cas d'erreur.

       Les données renvoyées par readdir() sont écrasées lors  de
       l'appel suivant à readdir() sur le même flux répertoire.

       D'après  POSIX, la structure dirent contient un champ char
       d_name[] de taille non spécifiée, avec  au  plus  NAME_MAX
       caractères  avant  le  caractère nul final.  L'utilisation
       des autres champs de cette structure compromet  la  porta­
       bilité de votre programme.

VALEUR RENVOYÉE
       La  fonction  readdir() renvoie un pointeur sur une struc­
       ture dirent, ou NULL  lorsqu'une  erreur  se  produit,  ou
       lorsque la fin du répertoire est atteinte.

ERREURS
       EBADF  Le flux répertoire dir est invalide.

CONFORMITÉ
       SVID 3, POSIX, BSD 4.3

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


TRADUCTION
       Christophe Blaess, 1997.














Linux                    5 Novembre 1996                        1