READDIR

名前

書式

#include <sys/types.h>

#include <dirent.h>

struct dirent *readdir(DIR *dir);

説明

Linux では dirent 構造体は以下のように定義されている:

struct dirent {
    ino_t          d_ino;       /* inode 番号 */
    off_t          d_off;       /* 次の dirent へのオフセット */
    unsigned short d_reclen;    /* このレコードの長さ */
    unsigned char  d_type;      /* ファイル種別 */
    char           d_name[256]; /* ファイル名 */
};

POSIX によると、 dirent 構造体にはサイズの明示されていない char d_name[] フィールドが含まれる。このフィールドには最大で NAME_MAX 文字と、それに続く終端の NULL バイトが格納される。 POSIX.1-2001 では XSI 拡張として ino_t d_ino フィールドについても記述している。 他のフィールドは非標準であり、全てのシステムに存在するわけではない。 詳細については、下記の「注意」を参照のこと。

readdir() によって返されるデータは、以降の同じストリームに対する readdir() の呼び出しによって上書きされる可能性がある。  

返り値

エラー

EBADF

ディレクトリストリームディスクリプタ dir が無効。

準拠

注意

Linux 以外では、 d_type フィールドは主に BSD 系のシステムでだけ存在する。 このフィールドがあると、 その後の動作がファイルの種別により決まる場合に、 stat() を呼び出すコストを避けることができる。 機能検査マクロ _BSD_SOURCE が定義された場合、glibc は d_type で返される値として以下のマクロ定数を定義する。

DT_UNKNOWN

ファイルタイプが不明である。

DT_REG

通常のファイルである。

DT_DIR

ディレクトリである。

DT_FIFO

名前付きパイプ、すなわち FIFO である。

DT_SOCK

Unix ドメインソケットである。

DT_CHR

キャラクタ・デバイスである。

DT_BLK

ブロック・デバイスである。

ファイル種別を決定できなかった場合には、 d_type に DT_UNKNOWN が入る。  

関連項目

Index

名前

書式

説明

返り値

エラー

準拠

注意

関連項目