Nom

readdir - Consulter un répertoire.

Résumé

.nf #include <sys/types.h> #include <dirent.h> struct dirent * readdir (DIR * dir ); .fi

Description

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

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 portabilité de votre programme. POSIX-2001 documente aussi le champ ino_t d_ino comme une extension XSI.

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

Valeur renvoyée

La fonction readdir() renvoie un pointeur sur une structure 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), closedir (3), dirfd (3), opendir (3), rewinddir (3), scandir (3), seekdir (3), telldir (3)

Traduction

Christophe Blaess, 1996-2003.