last modified: 2010-05-28

C语言标准库 - stdarg.h

7 变长变量表<stdarg.h>

头文件<stdarg.h>中的说明提供了依次处理含有未知数目和类型的函数变量表的机制。

7.1 va_start

7.2 va_arg

7.3 va_end

#include <stdarg.h>
void va_start(va_list ap, lastarg);
type va_arg(va_list ap, type);
void va_end(va_list ap);

假设函数f含有可变数目的变量,lastarg是它的最后一个有名参数,然后在f内说明一个类型为va_list的变量ap,它将依次指向每个变量:

va_list ap;

在访问任何未命名的变量前必须用va_start宏对ap进行初始化:

va_start(ap, lastarg);

此后,宏va_arg的每次执行将产生一个与下一个未命名的变量有相同类型和值的值,它同时还修改ap,以使下一次使用va_arg时返回下一个变量:

va_arg(ap, type);

当所有的变量处理完毕之后,f返回之前,必须调用一次宏va_end:

va_end(ap);

例子:函数sum_series()的第一个参数是变量项数。

double sum_series(int num, … )
{
    double sum = 0.0, t;
    va_list ap;

    va_start(ap, num);
    for (; num; num--) {
        t = va_arg(ap, double);
        sum += t;
    }
    va_end(ap);
    return sum;
}