scandir
函数用于列举指定目录下的文件列表,并将结果存储在一个动态分配的数组中。
函数原型:
int scandir(const char *dirpath, struct dirent ***namelist,
int (*filter)(const struct dirent *),
int (*compar)(const struct dirent **, const struct dirent **));
参数解释:
dirpath
:要列举文件的目录路径。namelist
:用于存储文件列表的指针数组的指针。这个指针数组将被动态分配内存以容纳文件列表,并且在成功时返回。filter
:可选参数,用于过滤文件的回调函数。如果传递NULL
,则表示不进行过滤。compar
:可选参数,用于排序文件列表的回调函数。如果传递NULL
,则表示不进行排序。
返回值解释:
- 成功时,返回文件列表中的文件数量。
- 失败时,返回一个负数。可以通过检查
errno
全局变量来获取错误代码。
当函数返回成功时,namelist
将指向一个动态分配的指针数组,每个指针指向一个 struct dirent
结构体,表示一个文件或子目录的元数据。
以下是一个简单示例,演示如何使用 scandir
函数列举目录下的文件列表:
#include <stdio.h>
#include <dirent.h>
int main() {
struct dirent **namelist;
int numEntries = scandir("/path/to/directory", &namelist, NULL, alphasort);
if (numEntries < 0) {
perror("scandir");
} else {
for (int i = 0; i < numEntries; i++) {
printf("File %d: %s\n", i, namelist[i]->d_name);
}
}
// 释放动态分配的内存
for (int i = 0; i < numEntries; i++) {
free(namelist[i]);
}
free(namelist);
return 0;
}
需要注意的是,对于每个成功的调用,都需要释放动态分配的内存,以避免内存泄漏。