opendir

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

opendir, fdopendir - ディレクトリをオープンする  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <sys/types.h>
#include <dirent.h>

DIR *opendir(const char *name);
DIR *fdopendir(int fd);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

fdopendir():

    Since glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    Before glibc 2.10:
        _GNU_SOURCE
 

説明

opendir() 関数は、ディレクトリ name に対応するディレクトリストリームをオープンし、そのストリームへのポインターを返す。ストリームの位置はディレクトリの先頭のエントリーに設定される。

fdopendir() 関数は opendir() と同様だが、オープン済みのファイルディスクリプター fd により参照されるディレクトリに対するディレクトリストリームを返す。 fdopendir() の呼び出しが成功した後は、 fd は実装の内部で使用される。アプリケーションは fd を他の場面で使用すべきではない。  

返り値

The opendir() and fdopendir() functions return a pointer to the directory stream. On error, NULL is returned, and errno is set to indicate the error.  

エラー

EACCES
アクセス権限がない。
EBADF
fd が読み出し用にオープンされた、有効なファイルディスクリプターではない。
EMFILE
オープンされたファイルディスクリプター数がプロセス単位の上限に達している。
ENAMETOOLONG
name was too long.
ENFILE
オープンされたファイルの総数がシステム全体の上限に達している。
ENOENT
ディレクトリが存在しないか、または name が空文字列である。
ENOMEM
操作を完了するのに十分なメモリーがない。
ENOTDIR
name はディレクトリではない。
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
opendir(), fdopendir() Thread safetyMT-Safe
 

標準規格

POSIX.1-2008.  

標準規格

opendir()
SVr4, 4.3BSD, POSIX.1-2001.
fdopendir()
POSIX.1-2008. glibc 2.4.
 

注意

ファイル名エントリーをディレクトリストリームから読み込むには readdir(3) を使用する。

ディレクトリストリームに対応するファイルディスクリプターは dirfd(3) を使用して取得できる。

opendir() 関数は、 DIR * に対応するファイルディスクリプターの close-on-exec フラグを設定する。 fdopendir() 関数は、ファイルディスクリプターの close-on-exec フラグの設定を変更しない。 fdopendir() の呼び出しが成功した際に、ファイルディスクリプター fd の close-on-exec を設定するかどうかは、 POSIX.1-200x では規定されていない。  

関連項目

open(2), closedir(3), dirfd(3), readdir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
標準規格
注意
関連項目

This document was created by man2html, using the manual pages.