Man page - telldir(3)

Packages contains this manual

Available languages:

en fr pt_BR es ko ja ru ro de

Manual

TELLDIR

名 前
書 式
説 明
返 り 値
エ ラ ー
属 性
準 拠
注 意
関 連 項 目
こ の 文 書 に つ い て

名 前

telldir - デ ィ レ ク ト リ ス ト リ ー ム 中 の 現 在 位 置 を 返 す

書 式

#include <dirent.h>

long telldir(DIR * dirp );

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

telldir ():
_XOPEN_SOURCE
|| /* glibc 2.19 以 降 : */ _DEFAULT_SOURCE
|| /* glibc 2.19 以 前 : */ _BSD_SOURCE || _SVID_SOURCE

説 明

telldir () 関 数 は 、 デ ィ レ ク ト リ ス ト リ ー ム dirp の 現 在 位 置 を 返 す 。

返 り 値

成 功 し た 場 合 、 telldir () 関 数 は デ ィ レ ク ト リ ス ト リ ー ム 中 の 現 在 位 置 を 返 す 。 エ ラ ー の 場 合 、 -1 が 返 り 、 errno が 適 切 に 設 定 さ れ る 。

エ ラ ー

EBADF

デ ィ レ ク ト リ ス ト リ ー ム デ ィ ス ク リ プ タ ー dirp が 無 効 で あ る 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-20969-1.png

準 拠

POSIX.1-2001, POSIX.1-2008, 4.3BSD.

注 意

バ ー ジ ョ ン 2.1.1 以 前 の glibc で は 、 telldir () の 返 り 値 の 型 は 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 プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。