函数 opendir 用来打开一个目录,readdir 用来读取目录中的内容,closedir 关闭一个已经打开的目录。
1.opendir
#include <sys/types.h>
#include <dirent.h>
DIR *opendir(const char *name);
DIR *fdopendir(int fd);
用来打开参数 name 指定的目录,并返回 DIR* 形态的目录流,类似于文件操作中的文件描述符,接下来对目录的读取和搜索都要使用此返回值。成功则返回 DIR* 形态目录流,失败测返回 NULL,错误代码存入 errno 中。
2.readdir
#include <sys/types.h>
#include <dirent.h>
struct dirent *readdir(DIR *dirp);
readdir 用来从参数dirp 所指向的目录中读取目录项信息,返回一个 struct dirent 结构的指针。
struct dirent 的定义如下
struct dirent {
ino_t d_ino; /* Inode number */
off_t d_off; /* Not an offset; see below */
unsigned short d_reclen; /* Length of this record */
unsigned char d_type; /* Type of file; not supported
by all filesystem types */
char d_name[256]; /* Null-terminated filename */
};
d_ino:指此目录 i 节点编号,不必理会
d_off:指目录文件开头至此目录进入点的位移
d_reclen:指 d_name 的长度
d_name:指以 NULL 结尾的文件名
调用 opendir 打开目录后,第一次调用该函数,则返回目录下第一个文件的信息,第二次调用函数返回第二个文件的信息,以此类推。如果没有文件信息可供读取,则返回 NULL。调用该函数是如果发生错误或读到目录文件尾,则返回 NULL,错误代发存入 errno 中。
3.closedir
#include <sys/types.h>
#include <dirent.h>
int closedir(DIR *dirp);
用来关闭一个已经打开的目录,执行成功返回 0,当有错误发生时返回 -1,错误代码存入 errno 中。