C语言API小结

主要是在学习NJU的OS时遇到的一些C语言API。仅以小结。

[toc]

C_API

文件类

列出文件夹下文件(Linux)

头文件

#include <dirent.h>

变量定义：

DIR* dir = opendir("/proc"); // 文件夹
struct dirent* entry; //遍历到的文件。其中entry->d_name为文件名
entry = readdir(dir); // 在指定目录下读取一个文件
closedir(dir); //关闭文件夹

tldr：

DIR *dir;
struct dirent* entry;

// open the /proc
dir = opendir("/proc");

if(dir){
    // scan files in /proc
    while((entry = readdir(dir)) != NULL){
        if(strcmp(entry->d_name, ".") != 0 && strcmp(entry->d_name, "..") != 0){
            printf("filename: %s\n", entry->d_name);
        }
    }
    closedir(dir);
}else{
    perror("open /proc failed.\n");
    return -1;
}

判断文件是文件还是文件夹

头文件：

#include <sys/stat.h>

变量定义：

struct stat file_stat; // 文件状态的struct，其中file_stat->st_mode可以用来判断文件类型
stat(const char* path, struct stat* buffer); // 获取指定文件的数据信息，存储在buffer中。返回值为0表示访问成功。
S_ISREG(mode_t mode); // 一个宏，用于判断其是否是文件
S_ISDIR(mode_t mode); // 同理判断是否是文件夹

tldr：

const char *path = "/path/to/file_or_directory";

struct stat file_stat;

// 获取文件信息
if (stat(path, &file_stat) == 0) {
    // 判断文件类型
    if (S_ISREG(file_stat.st_mode)) {
        printf("%s is a regular file.\n", path);
    } else if (S_ISDIR(file_stat.st_mode)) {
        printf("%s is a directory.\n", path);
    } else {
        printf("%s is neither a regular file nor a directory.\n", path);
    }
} else {
    perror("stat");
    return 1;
}

字符串类

分割字符串函数

头文件：

#include <string.h>

变量定义：

char* strtok(char* str, const char* split); // 以split来分隔str，返回值是第一个被分隔出来的字符串。
// 注意，该操作会将原字符串中被匹配到的split修改为'\0'。该函数含有一个静态指针，多次分隔同一字符串时第一个参数只需要设置为NULL。

tldr：

char str[] = "Hello,World,How,Are,You";
char *token;

token = strtok(str, ",");
while (token != NULL) {
    printf("%s\n", token);
    token = strtok(NULL, ",");
}

其他

接收可变参数库stdarg.h

头文件：

#include<stdarg.h>

变量定义：

va_list args; // 定义可变参数列表
va_start(args, last); // 根据last来初始化args列表。last表示最后一个固定的参数，将从此参数开始接收可变列表
va_arg(args, type); // 根据type来接收一个参数，类似于迭代器，会自动指向下一个参数。type可以为int、char、double等。 
va_end(args); // 结束接收参数

一个简单的例子如下：

#include <stdarg.h>

int sum(int count, ...)
{
    int result = 0;
    va_list args;
    va_start(args, count);

    for (int i = 0; i < count; i++)
    {
        int num = va_arg(args, int);
        result += num;
    }

    va_end(args);
    return result;
}

int main()
{
    printValues(3, 10, 20, 30); // 传递三个整数参数

    return 0;
}

可以看到，只需要在编写函数的接收参数的地方写下省略号，即可完成可变参数的接收。