READDIR

Section: Linux Programmer's Manual (3)
Updated: 11 June 1995
Index Return to Main Contents
 

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

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  

SEE ALSO

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:23:04 GMT, March 22, 2025