可变长参数的函数通常在参数列表的末尾使用省略号(…)定义。
举例如下:
#include<stdarg.h>
#include<stdio.h>
int sum(int, ...);//可变参数函数,用于求几个int数据的和
int main(void)
{
printf("10、20 和 30 的和 = %d\n", sum(3, 10, 20, 30) );
printf("4、20、25 和 30 的和 = %d\n", sum(4, 4, 20, 25, 30) );
return 0;
}
int sum(int num_args, ...)
{
int val = 0;
va_list ap;
int i;
va_start(ap, num_args);
for(i = 0; i < num_args; i++)
{
val += va_arg(ap, int);
}
va_end(ap);
return val;
}
对于上例中,sum函数的实现,主要是几个新面孔的使用:va_list,va_start,va_arg及va_end。
它们都定义在头文件stdarg.h中。
stdarg.h 头文件定义了一个变量类型 va_list 和三个宏,这三个宏可用于在参数个数未知(即参数个数可变)时获取函数中的参数。
va_list
这是一个适用于 va_start()、va_arg() 和 va_end() 这三个宏存储信息的类型。
一般情况下va_list所定义变量为字符指针,即typedef char *va_list
该类型的变量用于存储参数的地址。因为得到参数的地址之后,再结合参数的类型,才能得到参数的值。
va_start
宏原型是:
void va_start(va_list ap, last_arg)
参数:
ap是一个 va_list 类型的对象,它用来存储通过 va_arg 获取额外参数时所必需的信息。
last_arg是最后一个传递给函数的已知的固定参数。
该宏与 va_arg 和 va_end 宏是一起使用的,且必须在使用 va_arg 和 va_end 之前被调用。
va_arg
宏原型是:
type va_arg(va_list ap, type)
其作用是从ap开始取一个type型的值返回,并且自动将ap指向下一个参数。所以如果参数类型写错了,例如将char*写成char了,本来要取4个字节,结果只取了一个字节,ap本来要向后面移动4个字节,结果只移动了一个字节,后面的数据就全错了。
参数:
ap是一个 va_list 类型的对象,存储了有关额外参数和检索状态的信息。该对象应在第一次调用 va_arg 之前通过调用 va_start 进行初始化。
type这是一个类型名称。该类型名称是作为扩展自该宏的表达式的类型来使用的。
返回值:该宏返回下一个额外的参数,是一个类型为 type 的表达式。
注意:
va_arg宏的第2个参数不能被指定为char、short或者float类型。
因为char和short类型的参数会被转换为int类型,而float类型的参数会被转换为double类型。如果错误的指定了,将会在程序中引起麻烦。
例如,这样写肯定是不对的:
c = va_arg(ap,char);
因为我们无法传递一个char类型参数,如果传递了,它将会被自动转化为int类型。上面的式子应该写成:
c = va_arg(ap,int);
va_end
宏原型为:
void va_end(va_list ap)
参数:
ap是之前由同一函数中的 va_start 初始化的 va_list 对象。
其作用是作用是将ap设置为NULL,如果在从函数返回之前没有调用 va_end,则结果为未定义。
总结
使用可变长参数的步骤:
1.声明va_list变量;
2.使用va_start指定可变长参数的位置;
3.使用va_arg来获取参数值;
4.可选,使用va_end将va_list清零。
我们可以认为,调用可变长参数的函数时,传递给函数的参数是在堆栈中保存为一个紧挨一个的列表。获取参数的唯一方法就是通过参数列表的指针,取一个参数,移动一个参数长度的指针,实际上如何取参数完全掌握在用户手中,用户应当小心应对。
参考:
1:http://www.runoob.com/cprogramming/c-standard-library-stdarg-h.html
2:https://blog.youkuaiyun.com/frank_liuxing/article/details/18000825
3:《C缺陷和陷阱》附录A