Linux repositories inspector
22 April 1996
Aliases: readdir_r(3), readdir_r(3), readdir_r(3), readdir_r(3), readdir_r(3), readdir_r(3), readdir_r(3)

manpages-pt-dev

Portuguese Versions of the Manual Pages (dev sections)

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

NAME

readdir - read a directory

SYNOPSIS

#include <sys/types.h>

#include <dirent.h>
struct dirent *readdir(DIR *dir);

DESCRIPTION

The readdir() function returns a pointer to a dirent structure representing the next directory entry in the directory stream pointed to by dir. It returns NULL on reaching the end-of-file or if an error occurred.
The data returned by readdir() is overwritten by subsequent calls to readdir() for the same directory stream.
According to POSIX, the dirent structure contains a field char d_name[] of unspecified size, with at most NAME_MAX characters preceding the terminating null character. Use of other fields will harm the portability of your programs.

RETURN VALUE

The readdir() function returns a pointer to a dirent structure, or NULL if an error occurs or end-of-file is reached.

ERRORS

EBADF Invalid directory stream descriptor dir.

CONFORMING TO

SVID 3, POSIX, BSD 4.3
⇧ Top