标准C库关于操作目录的函数

前言

如果，想要深入的学习标准C库中opendir，readdir，closedir等这些有关于目录操作的函数，还是需要去自己阅读Linux系统中的帮助文档。
具体输入命令：

man 3 opendir/readdir/closedir

即可查阅到完整的资料信息。

opendir函数

opendir函数是标准C库中的一员，它的作用是：打开一个目录

它的函数原型是长这样的：

DIR *opendir(const char *name);

接下来，我来介绍一下它的参数与返回值

    参数：
        name: 需要打开的目录的名称
    返回值：
        DIR * 类型，理解为目录流
        错误返回NULL

在使用这个函数之前，我们需要往C/C++文件中导入这些头文件：

#include <sys/types.h>
#include <dirent.h>

readdir函数

readdir函数是标准C库中的一员，它的作用是：读取目录内的内容

它的函数原型是长这样的：

struct dirent *readdir(DIR *dirp);

接下来，我来介绍一下它的参数与返回值

    参数：
        dirp: dirp是opendir返回的结果
    返回值：
         struct dirent，代表读取到的文件的信息
        读取到了末尾或者失败了，返回NULL

在使用这个函数之前，我们需要往C/C++文件中导入这个头文件：

#include <dirent.h>

closedir函数

closedir函数是标准C库中的一员，它的作用是：关闭一个目录

它的函数原型是长这样的：

int closedir(DIR *dirp);

接下来，我来介绍一下它的参数与返回值

    参数：
        name: 需要关闭的目录的名称
    返回值：
        成功返回0，失败返回-1

在使用这个函数之前，我们需要往C/C++文件中导入这些头文件：

#include <sys/types.h>
#include <dirent.h>

现在介绍完这三个函数，我来用一个例子去演示一下这三个函数的用法：

代码演示：实现读取目录下所有普通文件个数的功能

// 导入头文件
#include <sys/types.h>
#include <dirent.h>
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
// 给出函数声明
int getFileNum(const char *path);

int main(int argc, char *argv[])
{
    if (argc < 2)
    {
        printf("%spath \n", argv[0]);
        return -1;
    }
    int num = getFileNum(argv[1]);
    printf(" 普通文件的数量为: %d\n", num);

    return 0;
}

// 编写getFileNum函数
int getFileNum(const char *path)
{
    // 打开目录
    DIR *dir = opendir(path);
    if (dir == NULL)
    {
        perror("opendir");
        exit(0);
    }
    // 记录普通文件的个数
    int total = 0;
    // 创建一个dirent结构体
    struct dirent *ptr;
    // 使用while循环不断地将目录中文件的内容导入到dirent结构体中去
    while ((ptr = readdir(dir)) != NULL)
    {
        // 获取名称
        char *dName = ptr->d_name;
        // 忽略掉. 和.. 这两个文件
        if (strcmp(dName, ".") == 0 || strcmp(dName, "..") == 0)
            continue;
        // 判断是否是普通文件还是目录,如果是目录就要继续递归遍历目录，是文件就 ++ 继续循环
        if (ptr->d_type == DT_DIR)
        {
            char subDir[256];
            sprintf(subDir, "%s/%s", path, dName);
            total += getFileNum(subDir);
        }
        if (ptr->d_type == DT_REG)
            total++;
    }
    

    // 关闭目录
    closedir(dir);
    return total;
}

运行程序，展示输出：

./app /home/nowcoder/Linux/lession14
 普通文件的数量为: 8