DIRECTORY(3)

名称
opendir, readdir, readdir_r, telldir, seekdir, rewinddir, closedir, dirfd - ディレクトリ操作

ライブラリ
libc

書式
<sys/types.h> <dirent.h> DIR * opendir(const char *filename) struct dirent * readdir(DIR *dirp) int readdir_r(DIR *dirp, struct dirent *entry, struct dirent **result) long telldir(DIR *dirp) void seekdir(DIR *dirp, long loc) void rewinddir(DIR *dirp) int closedir(DIR *dirp) int dirfd(DIR *dirp)

解説
opendir() 関数は、 filename で指定されたディレクトリを開き、 ディレクトリストリーム をそれに対応させ、後続の操作で ディレクトリストリーム を識別するのに使用するポインタを返します。 filename にアクセスできない場合、またはすべてのものを保持するのに十分なメモリを malloc(3) できない場合は、ポインタ NULL が返されます。

readdir() 関数は、次のディレクトリエントリを指すポインタを返します。 この関数は、ディレクトリの末尾に到達するか、または無効な seekdir() 操作を検出すると NULL を返します。

readdir_r() は、 readdir() と同様の機能を提供しますが、 呼び出し元は結果を格納するためのディレクトリ entry バッファを提供しなければなりません。 読み込みが成功すると result は entry を指し、ディレクトリの末尾に達すると result は NULL に設定されます。 readdir_r() は、成功した場合 0 を返し、そうでなければ失敗を示すエラーナンバを返します。

telldir() 関数は、指定された ディレクトリストリーム に関連付けられている現在の位置を返します。 telldir() が返す値が有効なのは、その値が引き出された元の DIR ポインタ dirp が生きている間だけです。 ディレクトリが閉じられ再び開かれると、 telldir() が返した以前の値はもはや有効ではありません。

seekdir() 関数は、その ディレクトリストリーム に対する次の readdir() 操作の位置を設定します。 新しい位置は、その ディレクトリストリーム と関連付けられているもので、 telldir() 操作が実行されたときに返されるものです。

rewinddir() 関数は、指定された ディレクトリストリーム の位置をそのディレクトリの先頭に戻します。

closedir() 関数は、指定された ディレクトリストリーム を閉じ、 dirp ポインタに関連付けられた構造体を解放します。 処理が成功した場合は 0 を返します。 処理が失敗すると -1 が返され、エラーを示ためにグローバル変数 errno が設定されます。

dirfd() 関数は、指定された ディレクトリストリーム に関連付けられた整数のファイル記述子を返します。 open(2) を参照してください。

ディレクトリでエントリ ``name'' を検索するサンプルコードは次のとおりです。

    len = strlen(name);
    dirp = opendir(".");
    while ((dp = readdir(dirp)) != NULL)
            if (dp->d_namlen == len && !strcmp(dp->d_name, name)) {
                    (void)closedir(dirp);
                    return FOUND;
            }
    (void)closedir(dirp);
    return NOT_FOUND;

関連項目
close(2), lseek(2), open(2), read(2), dir(5)

歴史
opendir(), readdir(), telldir(), seekdir(), rewinddir(), closedir() および dirfd() の各関数は 4.2BSD で登場しました。