【Linux系统调用API】六、目录操作相关函数

2024-08-08 17:08:01 浏览数 (2)

1. getcwd函数

  • 包含头文件
代码语言:javascript复制
#include <unistd.h>
  • 函数原型
代码语言:javascript复制
char *getcwd(char *buf, size_t size);
char *getwd(char *buf);
char *get_current_dir_name(void);
  • 函数功能 These functions return a null-terminated string containing an absolute pathname that is the current working directory of the calling process. 获得进程的当前工作路径。
  • 函数参数
    • buf:缓冲区,用于存放目录。The pathname is returned as the function result and via the argument buf, if present.
    • size:缓冲区大小
  • 函数返回值
    • On success, these functions return a pointer to a string containing the pathname of the current working directory. In the case getcwd() and getwd() this is the same value as buf. 成功返回指向路径名字符串的指针。
    • On failure, these functions return NULL, and errno is set to indicate the error. The contents of the array pointed to by buf are undefined on error. 失败返回NULL。

2. chdir函数

  • 包含头文件
代码语言:javascript复制
#include <unistd.h>
  • 函数原型
代码语言:javascript复制
int chdir(const char *path);
int fchdir(int fd);
  • 函数功能 chdir() changes the current working directory of the calling process to the directory specified in path.改变进程的工作路径。
  • 函数参数
    • path:目标路径,也就是将当前进程的工作路径改为path。
  • 函数返回值
    • 成功返回0。On success, zero is returned.
    • 失败返回-1且设置errno。On error, -1 is returned, and errno is set appropriately.

示例:改变进程当前工作路径并打屏

代码语言:javascript复制
/************************************************************
  >File Name  : chdir_test.c
  >Author     : QQ
  >Company    : QQ
  >Create Time: 2022年05月16日 星期一 21时36分37秒
************************************************************/
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>

int main(int argc, char*argv[])
{
    /*切换当前进程的工作路径,注意是当前进程,也就是main进程的工作路径*/
    chdir(argv[1]);
    /*在新的路径创建一个文件来证明路径切换成功*/
    int fd = open("hello.txt", O_CREAT | O_RDONLY);
    close(fd);
    char buf[512];
    getcwd(buf, sizeof(buf));
    printf("current path : %sn", buf);
    return 0;
}

首先,看测试结果中打印的内容,getcwd()函数获取到的路径确实是我们通过chdir()函数指定的路径,并且test路径从无到有增加了一个文件,也证明我们切换工作路径成功了。但是有些人可能会有一个疑惑,看途中的红色箭头标记,既然当前工作路径已经切换为①所标识的路径了,那么为什么②处显示的工作路径还是原来的路径呢?这是因为,我们在程序中使用chdir()函数切换的路径是进程 ./chdir_test 的路径,也就是说 ./chdir_test 的路径被切换为①了,并且测试结果(hello.txt文件的创建)也证明切换成功。而②所标识的路径是当前shell进程的工作路径,它们俩根本不是一回事。

3. mkdir函数

  • 包含头文件
代码语言:javascript复制
#include <sys/stat.h>
#include <sys/types.h>
  • 函数原型
代码语言:javascript复制
int mkdir(const char *pathname, mode_t mode);
  • 函数功能 mkdir() attempts to create a directory named pathname. 创建一个目录。
  • 函数参数
    • pathname:路径名
    • mode:(mode & ~umask & 0777),和文件不同的是,目录必须有可执行权限才能进入目录,所以新建的目录必须要有可执行权限。(如果目录没有可执行权限,那么将无法进入该目录,所以新建时可以给满权限777)
  • 函数返回值 mkdir() returns zero on success, or -1 if an error occurred (in which case, errno is set appropriately).

示例:使用mkdir命令和mkdir()函数分别新建一个目录

代码语言:javascript复制
/************************************************************
  >File Name  : mkdir_test.c
  >Author     : QQ
  >Company    : QQ
  >Create Time: 2022年05月16日 星期一 22时11分29秒
************************************************************/
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/stat.h>

int main(int argc, char* argv[])
{
    if(argc < 2)
    {
        printf("not found filenamen");
        return -1;  
    }
    mkdir(argv[1], 0777);
    return 0;
}

通过这个例子可以得到,如果想要使用mkdir()函数创建的目录达到和mkdir命令创建目录有一样的权限,可以给mode参数0777满权限。

4. rmdir函数

  • 包含头文件
代码语言:javascript复制
#include <unistd.h>
  • 函数原型
代码语言:javascript复制
int rmdir(const char *pathname);
  • 函数功能 rmdir() deletes a directory, which must be empty. 只能删除空目录。
  • 函数参数
    • pathname:文件名及路径
  • 函数返回值
    • 成功返回0。On success, zero is returned.
    • 失败返回-1且设置errno。On error, -1 is returned, and errno is set appropriately.

5.opendir函数

  • 包含头文件
代码语言:javascript复制
#include <sys/types.h>
#include <dirent.h>
  • 函数原型
代码语言:javascript复制
DIR *opendir(const char *name);
DIR *fdopendir(int fd);
  • 函数功能 The opendir() function opens a directory stream corresponding to the directory name, and returns a pointer to the directory stream. The stream is positioned at the first entry in the directory. 打开目录。
  • 函数参数
    • name:目录名字。
  • 函数返回值
    • The opendir() and fdopendir() functions return a pointer to the directory stream. 返回一个指向目录流的指针DIR*,指向目录项的信息。
    • On error, NULL is returned, and errno is set appropriately.

6. readdir函数

  • 包含头文件
代码语言:javascript复制
#include <dirent.h>
  • 函数原型
代码语言:javascript复制
struct dirent *readdir(DIR *dirp);
int readdir_r(DIR *dirp, struct dirent *entry, struct dirent **result);
  • 函数功能 读目录。
  • 函数参数
    • dirp:传入opendir返回的指针。
  • 函数返回值
    • On success, readdir() returns a pointer to a dirent structure. If the end of the directory stream is reached, NULL is returned and errno is not changed. 成功返回一个结构体,结构体定义如下 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; not supported by all file system types */ char d_name[256]; /* filename */ }; 判断读到内容的类型,依据是结构体成员d_type,类型如下 /* d_type: DT_BLK This is a block device. 块设备 DT_CHR This is a character device. 字符设备 DT_DIR This is a directory. 目录 DT_FIFO This is a named pipe (FIFO). 管道 DT_LNK This is a symbolic link. 符号链接(软链接) DT_REG This is a regular file. 普通文件 DT_SOCK This is a Unix domain socket. socket DT_UNKNOWN The file type is unknown. 未知 */
    • On error, NULL is returned and errno is set appropriately.

7. closedir函数

  • 包含头文件
代码语言:javascript复制
#include <sys/types.h>
#include <dirent.h>
  • 函数原型
代码语言:javascript复制
int closedir(DIR *dirp);
  • 函数功能 关闭目录。
  • 函数参数
    • dirp:传入opendir返回的指针。
  • 函数返回值
    • The closedir() function returns 0 on success.
    • On error, -1 is returned, and errno is set appropriately.

示例:递归子目录统计普通文件个数

代码语言:javascript复制
/************************************************************
  >File Name  : count_file.c
  >Author     : QQ
  >Company    : QQ
  >Create Time: 2022年05月17日 星期二 12时40分35秒
************************************************************/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <dirent.h>
#include <sys/types.h>

int gFileNum = 0;

void file_count(char* dirname)
{
    /*打开目录*/
    DIR* dir = opendir(dirname);
    if(dir == NULL) /*打开失败则退出*/
    {
        perror("opendir err");
        exit(-1);   
    }   
    struct dirent* dentp = NULL;
    while((dentp = readdir(dir)) != NULL) /*不为NULL说明未读到末尾*/
    {
        if(dentp->d_type == DT_DIR) /*如果是目录则递归进入目录*/
        {
            if((strcmp(".", dentp->d_name) == 0) || (strcmp("..", dentp->d_name) == 0)) /*如果是当前目录或上一级目录则跳过*/
            {
                continue;   
            }
            /*每次递归都要把上一级目录加上,不然的话,进程找不到子目录所在的路径*/
            char namebuf[512];
            memset(namebuf, 0, sizeof(namebuf));
            sprintf(namebuf, "%s/%s", dirname, dentp->d_name);
            file_count(namebuf);
        }
        if(dentp->d_type == DT_REG) /*如果是文件,则计数*/
        {
            gFileNum  ;
        }
    }
    closedir(dir);
}

int main(int argc, char* argv[])
{
    if(argc != 2)
    {
        printf("tip: ./exe dirnamen");
        return -1;  
    }
    /*递归目录,统计普通文件个数*/
    file_count(argv[1]);
    printf("num: %dn", gFileNum);
    return 0;
}

编译运行,并通过shell命令find来验证结果

shell命令统计文件个数的命令

代码语言:javascript复制
find ./ -type f | wc -l

8. 目录读写位置函数

8.1 rewinddir()把目录指针恢复到起始位置

  • 包含头文件
代码语言:javascript复制
#include <sys/types.h>
#include <dirent.h>     
  • 函数原型
代码语言:javascript复制
void rewinddir(DIR *dirp);

8.2 telldir()获取目录读写位置

  • 包含头文件
代码语言:javascript复制
#include <dirent.h>
  • 函数原型
代码语言:javascript复制
long telldir(DIR *dirp);

8.3 seekdir()修改目录读写位置

  • 包含头文件
代码语言:javascript复制
#include <dirent.h>
  • 函数原型
代码语言:javascript复制
void seekdir(DIR *dirp, long offset);
  • 函数返回值 On success, the telldir() function returns the current location in the directory stream. On error, -1 is returned, and errno is set appropriately.

0 人点赞