【Linux C中文函数手册】之 目录操作函数
目录操作函数
1)closedir 关闭目录
相关函数: opendir
表头文件: #include<sys/types.h>
#include<dirent.h>
定义函数: int closedir(DIR *dir);
函数说明: closedir()关闭参数dir所指的目录流。
返回值: 关闭成功则返回0，失败返回-1，错误原因存于errno 中。
错误代码: EBADF 参数dir为无效的目录流
2)fchdir 改变当前的工作目录
相关函数: getcwd，chroot
表头文件: #include<unistd.h>
定义函数: int fchdir(int fd);
函数说明: fchdir()用来将当前的工作目录改变成以参数fd 所指的文件描述符。
返回值： 执行成功则返回0，失败返回-1，errno为错误代码。
范例:
#include<sys/types.h>
#include<sys/stat.h>
#include<fcntl.h>
#include<unistd.h>
void main()
{
int fd;
fd = open(“/tmp”,O_RDONLY);
fchdir(fd);
printf(“current working directory : %s \n”,getcwd(NULL,NULL));
close(fd);
}
执行结果：
current working directory : /tmp
3)opendir 打开目录
相关函数： open，readdir，closedir，rewinddir，seekdir，telldir，scandir
表头文件：#include<sys/types.h>
#include<dirent.h>
定义函数： DIR * opendir(const char * name);
函数说明： opendir()用来打开参数name指定的目录，并返回DIR*形态的目录流，和open()类似，
接下来对目录的读取和搜索都要使用此返回值。
返回值： 成功则返回DIR* 型态的目录流，打开失败则返回NULL。
错误代码：
EACCESS 权限不足
EMFILE 已达到进程可同时打开的文件数上限。
ENFILE 已达到系统可同时打开的文件数上限。
ENOTDIR 参数name非真正的目录
ENOENT 参数name 指定的目录不存在，或是参数name 为一空字符串。
ENOMEM 核心内存不足。
4)readdir 读取目录
相关函数： open，opendir，closedir，rewinddir，seekdir，telldir，scandir
表头文件：#include <sys/types.h>
#include <dirent.h>
定义函数: struct dirent * readdir(DIR * dir);
函数说明: readdir()返回参数dir目录流的下个目录进入点。
结构dirent定义如下
struct dirent
{
long d_ino; /* inode number 索引节点号 */
off_t d_off; /* offset to this dirent 在目录文件中的偏移 */
unsigned short d_reclen; /* length of this d_name 文件名长 */
unsigned char d_type; /* the type of d_name 文件类型 */
char d_name [NAME_MAX+1]; /* file name (null-terminated) 文件名，最长256字符 */
}
返回值: 成功则返回下个目录进入点。有错误发生或读取到目录文件尾则返回NULL。
附加说明: EBADF参数dir为无效的目录流。
5)rewinddir 重设读取目录的位置为开头位置
相关函数: open，opendir，closedir，telldir，seekdir，readdir，scandir
表头文件: #include<sys/types.h>
#include<dirent.h>
定义函数: void rewinddir(DIR *dir);
函数说明: rewinddir()用来设置参数dir 目录流目前的读取位置为原来开头的读取位置。
错误代码: EBADF dir为无效的目录流
6)seekdir 设置下回读取目录的位置
相关函数: open，opendir，closedir，rewinddir，telldir，readdir，scandir
表头文件: #include<dirent.h>
定义函数: void seekdir(DIR * dir,off_t offset);
函数说明: seekdir()用来设置参数dir目录流目前的读取位置，在调用readdir()时便从此新位置开始读取。
参数offset 代表距离目录文件开头的偏移量。
错误代码: EBADF 参数dir为无效的目录流
7)telldir 取得目录流的读取位置
相关函数: open，opendir，closedir，rewinddir，seekdir，readdir，scandir
表头文件: #include<dirent.h>
定义函数: off_t telldir(DIR *dir);
函数说明: telldir()返回参数dir目录流目前的读取位置。此返回值代表距离
目录文件开头的偏移量返回值返回下个读取位置，有错误发生时返回-1。
错误代码: EBADF参数dir为无效的目录流。
