首先，明确一个类型DIR的含义：

#include <dirent.h>
 
DIR    A type representing a directory stream.(指向一个目录的指针)

 

DIR是在目录项格式头文件dirent.h中定义的，它表示一个目录流类型。

一、opendir - open a directory

 

SYNOPSIS
#include <sys/types.h>
#include <dirent.h>
 
DIR *opendir(const char *name);
 
DESCRIPTION

opendir函数打开一个与给定的目录名name相对应的目录流，并返回一个指向该目录流的指针。打开后，该目录流指向了目录中的第一个目录项。

 

RETURN VALUE

 

opendir函数，打开成功，返回指向目录流的指针；打开失败，则返回NULL，并设置相应的错误代码errno。

例如：

DIR *dir = opendir(“/home/bamp/newdir”);
     if(NULL != dir){
        /**
           ...
*/ 
}

二、readdir - read a directory

 

SYNOPSIS
#include <sys/types.h>
#include <dirent.h>
 
struct dirent *readdir(DIR *dir);
 
DESCRIPTION

readdir函数返回一个指向dirent结构体的指针，该结构体代表了由dir指向的目录流中的下一个目录项；如果读到end-of-file或者出现了错误，那么返回NULL。

 

在Linux系统中，dirent结构体定义如下：

 

struct dirent {
             ino_t          d_ino;       /* inode number */
             off_t          d_off;       /* offset to the next dirent */
             unsigned short d_reclen;    /* length of this record */
             unsigned char  d_type;      /* type of file */
             char           d_name[256]; /* filename */
         };

 

readdir函数返回的值会被后续调用的（针对同一目录流的）readdir函数返回值所覆盖。

 

RETURN VALUE

 

readdir函数，成功时返回一个指向dirent结构体的指针；失败时或读到end-of-file时，返回NULL，并且设置相应的错误代码errno。

注:实质相应目录下的文件.

例如：

struct dirent* ptr = NULL;
为通过opendir打开执行目录流的指针
//相关处理操作
}

三、closedir - close a directory

SYNOPSIS
#include <sys/types.h>
#include <dirent.h>
int closedir(DIR *dir);
 
DESCRIPTION:

closedir函数关闭与指针dir相联系的目录流。关闭后，目录流描述符dir不再可用。

 

RETURN VALUE

 

closedir函数，成功时返回0；失败是返回-1，并设置相应的错误代码errno。

四、chdir, fchdir - change working directory

 

SYNOPSIS
#include <unistd.h>
 
int chdir(const char *path);
int fchdir(int fd);
 
DESCRIPTION

 

chdir函数改变当前工作目录为path指定的目录。

 

fchdir函数与chdir功能一样，唯一的区别是fchdir所要改变成的工作目录由打开的文件描述符指定。

 

RETURN VALUE

 

成功，返回0；失败，返回-1，并设置相应的错误代码errno。

 

五.可能用到的某些函数

rename函数的使用方法，

  rename（更改文件名称或位置）

相关函数

表头文件

定义函数

函数说明

的文件名称。若newpath所指定的文件已存在，则会被删除。

返回值 执行成功则返回0，失败返回-1，错误原因存于errn