Company Innovation Man pages Tech News Developer Mirrors Search
 
READDIR   (3) manpage
READDIR
3
1996-04-22
Linux Programmer's Manual
  • 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.
      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.
      POSIX 1003.1-2001 also documents the field
      "ino_t d_ino"
       as an XSI extension.
      The data returned by readdir() may be 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, BSD 4.3, POSIX 1003.1-2001
  • SEE ALSO
Current Users: 40 © 1999-2006 Linux.com.hk PenguinSoft
All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.