C 可变参数 stdarg.h

C语言 stdarg.h头文件定义了一个使用可变参数的方法，可以用来定义参数个数不固定的函数，其步骤如下：

    1. 提供一个使用省略号的函数原型

    2. 在函数定义中创建一个va_list类型的变量

    3. 用宏 va_start()把该变量初始化为一个参数列表

    4. 用宏va_arg()访问参数列表

    5. 用宏va_end()完成清理工作

声明的函数原型至少有一个形参列表和一个省略号，并且省略号只能出现在形参列表的最后，例如：

void f1(int n, ...);    // 有效，其中 n 为parmN形参，表示可变参数的个数
void f2(const char *s, int k, ...);    // 有效，其中 k 为parmN形参，表示可变参数的个数
char f3(cahr c1, ..., char c2);    // 无效，... 只能出现在可变参数列表最后
double f4(...);    // 无效，至少有一个形参（parmN形参），来指明可变参数的个数    

对使用可变参数中的宏的解释：

    1. va_list：用来存储形参对应的形参列表中省略号部分的数据对象

    2. va_start：把参数列表拷贝到va_list类型的变量中。该宏有两个参数：va_list变量和parmN形参

    3. va_arg：返回形参列表中的项。该宏接受两个参数：va_list类型的变量和类型名（如int ,double或其它类型）

    4. va_end：清理，清理后，va_list类型的变量变不可在用

示例：

double sum(int lim, ...)
{
    va_list ap;    // 声明一个存储参数的对象
    va_start(ap, lim);    // 把ap初始化为参数列表
    
    double tic;
    int toc;
    ...
    tic = va_arg(ap, double);    // 检索第一个参数，假设第一个参数为 double 类型
    toc = va_arg(ap, int);    // 检索第二个参数，假设第二个参数为 int 类型
    ...

    va_end(ap);    // 清理工作
    ...
}

说明：摘自《C Primer Plus》第16章 C预处理器和C库 16.14 可变参数：stdarg.h