DIRECTOR.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:2k
- DIRECTORY(3) Minix Programmer's Manual DIRECTORY(3)
- NAME
- directory, opendir, readdir, rewinddir, closedir, telldir, seekdir -
- directory routines
- SYNOPSIS
- #include <sys/types.h>
- #include <dirent.h>
- DIR *opendir(const char *dirname)
- struct dirent *readdir(DIR *dirp)
- void rewinddir(DIR *dirp)
- int closedir(DIR *dirp)
- #define _MINIX 1
- #include <sys/types.h>
- #include <dirent.h>
- long telldir(DIR *dirp)
- int seekdir(DIR *dirp, long pos)
- DESCRIPTION
- These routines form a system independent interface to access directories.
- Opendir() opens the directory dirname and returns a pointer to this open
- directory stream.
- Readdir() reads one entry from the directory as a pointer to a structure
- containing the field d_name, a character array containing the null-
- terminated name of the entry.
- Rewinddir() allows the directory to be read again from the beginning.
- Closedir() closes the directory and releases administrative data.
- The Minix specific functions telldir() and seekdir() allow one to get the
- current position in the directory file and to return there later.
- Seekdir() may only be called with a position returned by telldir() or 0
- (rewind). These functions should not be used in portable programs.
- SEE ALSO
- dir(5).
- DIAGNOSTICS
- Opendir() returns a null pointer if dirname can't be opened, or if it
- can't allocate enough memory for the DIR structure.
- Readdir() returns null if there are no more directory entries or on
- error.
- 1
- DIRECTORY(3) Minix Programmer's Manual DIRECTORY(3)
- Closedir() and seekdir() returns 0 on success, -1 on error.
- Telldir() returns -1 on error.
- All of them set errno appropriately. Readdir() will only set errno on
- error, not on end-of-dir, so you should set errno to zero beforehand, and
- check its value if readdir() returns null.
- NOTES
- The return value of readdir() needs to be copied before the next
- operation on the same directory if it is to be saved.
- AUTHOR
- Kees J. Bot (kjb@cs.vu.nl)
- 2