Read a directory (reentrant)
#include <sys/types.h> #include <dirent.h> int readdir_r( DIR *dirp, struct dirent *entry, struct dirent **result ); int readdir64_r( DIR *dirp, struct dirent64 *dirent, struct dirent64 **result );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The readdir_r() and readdir64_r() functions initialize the dirent structure referenced by entry with the directory entry at the current position in the directory stream referred to by dirp, store a pointer to this structure in *result, and position the directory stream at the next entry. If you've reached the end of the directory stream, these functions set *result to NULL. The readdir64_r() function is a large-file support version of readdir_r().
The storage pointed to by entry must be large enough for a dirent or direct64 structure with the d_name member an array of char containing at least NAME_MAX plus one element. The struct dirent and struct dirent64 structures don't include space for the pathname; you must provide it. For example:
struct dirent *entry; entry = malloc( offsetof(struct dirent, d_name) + NAME_MAX + 1 );
Some filesystems support names that are longer than the value of NAME_MAX. You can use pathconf() with _PC_NAME_MAX to determine the maximum number of bytes (not including the terminating null) allowed in a file name for a particular filesystem.
readdir_r() is POSIX 1003.1; readdir64_r() is Large-file support
Safety: | |
---|---|
Cancellation point | Yes |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |