处理变长参数的利器------valist

1. valist 简介

C语言标准库中头文件stdarg.h声明了一组能够变长参数的宏。主要有：

1、va_list 用来声明一个表示参数表中各个参数的变量。
2、va_start 初始化一个指针来指向变长参数列表的头一个变量（注意，…只能出现在参数表的最后）
3、va_arg每次调用时都会返回当前指针指向的变量，并将指针挪至下一个位置，参数的类型需要在这个调用的第二个参数来指定，va_arg也是根据这个参数来判断偏移的距离。
4、va_end需要在函数最后调用，来进行一些清理工作。

2. example

int LOG(int level, const char *fmt, ...)
{
    int ret = 0;
    char logStr[4096];
    va_list ap;
    va_start(ap, fmt);
    memset(logStr, 0, sizeof(logStr));
    vsnprintf(logStr, sizeof(logStr), fmt, ap);
    va_end(ap);
    fprintf(stderr, "%s\n", logStr);
    return ret;
};

3. 神奇的 vsnprintf函数

snprintf和valist是好搭档，配合实现上述效果。
snprintf的函数原型

int snprintf(char *str, size_t size, const char *format, ...)

将可变个参数(…)按照format格式化成字符串，然后将其复制到str中
(1) 如果格式化后的字符串长度 < size，则将此字符串全部复制到str中，并给其后添加一个字符串结束符(‘\0’)；
(2) 如果格式化后的字符串长度 >= size，则只将其中的(size-1)个字符复制到str中，并给其后添加一个字符串结束符(‘\0’)，返回值为欲写入的字符串长度。

4. V字头函数与普通青年对比

#include <stdio.h>
       int printf(const char *format, ...); //输出到标准输出
       int fprintf(FILE *stream, const char *format, ...); //输出到文件
       int sprintf(char *str, const char *format, ...); //输出到字符串str中
       int snprintf(char *str, size_t size, const char *format, ...); //按size大小输出到字符串str中

以下函数功能与上面的一一对应相同，只是在函数调用时，把上面的...对应的一个个变量用va_list调用所替代。在函数调用前ap要通过va_start()宏来动态获取。
#include <stdarg.h>
       int vprintf(const char *format, va_list ap);
       int vfprintf(FILE *stream, const char *format, va_list ap);
       int vsprintf(char *str, const char *format, va_list ap);
       int vsnprintf(char *str, size_t size, const char *format, va_list ap);