ql_readdir

ql_readdir() 函数是 QuickLink API 中的一个函数，用于读取指定目录下的文件列表。它的语法如下：

int ql_readdir(const char *dirname, struct dirent ***namelist, int (*filter)(const struct dirent *),
               int (*compar)(const struct dirent **, const struct dirent **));

参数说明：

- `dirname`：要读取文件列表的目录路径；
- `namelist`：存储读取到的文件列表的指针，由函数内部分配内存，使用后需要手动释放；
- `filter`：可选的文件筛选函数，用于过滤掉不需要的文件，如果不需要过滤则传入 NULL；
- `compar`：可选的文件排序函数，用于对读取到的文件列表进行排序，如果不需要排序则传入 NULL。

函数返回值为读取到的文件数，如果出错则返回 -1。

注意，使用完 `namelist` 后需要通过 `free()` 函数手动释放内存，否则会造成内存泄漏。例如：

struct dirent **namelist = NULL;
int n = ql_readdir("/path/to/dir", &namelist, NULL, NULL);
if (n < 0) {
    perror("ql_readdir");
    exit(EXIT_FAILURE);
}
for (int i = 0; i < n; i++) {
    printf("%s\n", namelist[i]->d_name);
}
for (int i = 0; i < n; i++) {
    free(namelist[i]);
}
free(namelist);