READDIR(3)

名前
readdir - ディレクトリを読み込む

書式
#include <sys/types.h>

#include <dirent.h>

struct dirent *readdir(DIR *dir);

説明
readdir() 関数は、dir で指されるディレクトリストリームの 中の次のディレクトリエントリを示す dirent 構造体へのポインタを返す。 ファイルの最後に達した場合やエラーが発生した場合は NULL を返す。

readdir() によって返されるデータは、以降の同じストリームに対する readdir() の呼び出しによって上書きされる。

POSIX によると、 dirent 構造体はサイズの明示されていない char d_name[] フィールドを含んでおり、最大 NAME_MAX の文字と、終端するヌル文字が格納されている。 他のフィールドを使用することは、プログラムの可搬性を損なうことに なるだろう。

返り値
readdir() 関数は dirent 構造体へのポインタを返す。 エラーが発生するか、ファイルの最後に達した場合は NULL を返す。

エラー

EBADF
    ディレクトリストリームディスクリプタ dir が無効。

準拠
SVID 3, POSIX, BSD 4.3

関連項目
read(2), opendir(3), closedir(3), rewinddir(3), seekdir(3), telldir(3), scandir(3)