#include <sys/types.h>

#include <dirent.h>

struct dirent * readdir (DIR * dir);

Sous Linux, la structure dirent est définie de la façon suivante :

struct dirent {
    ino_t          d_ino;       /* numéro d'i-noeud */
    off_t          d_off;       /* offset jusqu'à la dirent suivante */
    unsigned short d_reclen;    /* longueur de cet enregistrement */
    unsigned char  d_type;      /* type de file */
    char           d_name[256]; /* nom du fichier */
};

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 l'octet nul final. POSIX.1-2001 documente aussi le champ ino_t d_ino comme une extension XSI. Les autres champs ne sont pas normalisés et ne sont pas présents sur tous les systèmes ; voir NOTES plus loin pour plus de détails.

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

EBADF

Le flux répertoire dir est invalide.

Ailleurs que sous Linux, le champ d_type n'est principalement disponible que sur les systèmes BSD. Ce champ rend possible d'éviter la dépense de l'appel stat(2) si d'autres actions dépendent du type de fichier. Si la macro de test de fonctionalité _BSD_SOURCE est définie, la glibc définit les constantes suivantes pour la valeur renvoyée dans d_type :

DT_UNKNOWN

Le type de fichier est inconnu.

DT_REG

C'est un fichier régulier.

DT_DIR

C'est un répertoire.

DT_FIFO

C'est un tube nommé ou une FIFO.

DT_SOCK

C'est une socket de domaine Unix.

DT_CHR

C'est un périphérique de caractères.

DT_BLK

C'est un périphérique de blocs.

Si le type de fichier ne peut pas être déterminé, la valeur DT_UNKNOWN est renvoyée dans d_type.  

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 5 novembre 1996 et révisée le 29 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 readdir ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

NOTES

CONFORMITÉ

VOIR AUSSI

TRADUCTION