tail head cat sleep
QR code linking to this page

manページ  — DIRECTORY

名称

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

内容

ライブラリ

Standard C Library (libc, -lc)

書式

#include <sys/types.h>
#include <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 バッファを提供しなければなりません。 読み込みが成功すると resultentry を指し、ディレクトリの末尾に達すると 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() の各関数は BSD 4.2 で登場しました。

DIRECTORY (3) June 4, 1993

tail head cat sleep
QR code linking to this page


このマニュアルページサービスについてのご意見は Ben Bullock にお知らせください。 Privacy policy.

This philosophy, in the hands of amateurs, leads to inexplicably mind-numbing botches like the existence of two programs, “head” and “tail,” which print the first part or the last part of a file, depending. Even though their operations are duals of one another, “head” and “tail” are different programs, written by different authors, and take different options!
— The Unix Haters' handbook