名 前
telldir − デ ィ レ ク ト リ ス ト リ ー ム 中 の 現 在 位 置 を 返 す
書 式
#include <dirent.h>
long telldir(DIR *dirp);
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
telldir(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
説 明
telldir() 関 数 は 、 デ ィ レ ク ト リ ス ト リ ー ム dirp に 結 び つ け ら れ た 現 在 位 置 を 返 す 。
返 り 値
成 功 し た 場 合 、 telldir() 関 数 は デ ィ レ ク ト リ ス ト リ ー ム 中 の 現 在 位 置 を 返 す 。 エ ラ ー の 場 合 、 −1 が 返 さ れ て 、 errno が 適 切 に 設 定 さ れ る 。
エ ラ ー
|
EBADF デ ィ レ ク ト リ ス ト リ ー ム デ ィ ス ク リ プ タ ー |
dirp が 無 効 で あ る 。 |
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )
telldir() 関 数 は ス レ ッ ド セ ー フ で あ る 。
準 拠
4.3BSD, POSIX.1−2001.
注 意
バ ー ジ ョ ン 2.1.1 以 前 の glibc で は 、 telldir()9 の 返 り 値 の 型 は off_t で あ っ た 。 POSIX.1−2001 で は long と 規 定 さ れ て お り 、 glibc 2.1.2 以 降 で は long に な っ て い る 。 初 期 の フ ァ イ ル シ ス テ ム で は 、 telldir() が 返 す 値 は 単 な る デ ィ レ ク ト リ 内 の フ ァ イ ル オ フ セ ッ ト で あ っ た 。 新 し め の フ ァ イ ル シ ス テ ム で は 、 デ ィ レ ク ト リ を 表 現 す る の に 、 フ ラ ッ ト な テ ー ブ ル で は な く 、 ツ リ ー や ハ ッ シ ュ 構 造 が 使 用 さ れ て い る 。 こ の よ う な フ ァ イ ル シ ス テ ム で は 、 telldir() が 返 す 値 (お よ び readdir(3) が 内 部 で 使 用 す る 値 ) は 、 デ ィ レ ク ト リ 内 で の 値 を 示 す の に フ ァ イ ル シ ス テ ム 実 装 が 使 っ て い る "cookie" と な る 。 ア プ リ ケ ー シ ョ ン プ ロ グ ラ ム で は 、 必 ず こ の 値 を 内 容 を 意 識 せ ず 単 な る 値 と し て 扱 う べ き で あ り 、 そ の 内 容 に つ い て 前 提 を 持 つ べ き で は 「 な い 」 。
関 連 項 目
closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。