va_list 是C语言中解决变参问题的一组宏。
1.API介绍:
头文件:
#include <stdarg.h>
下面是实现变参函数的一组宏(macro):
void va_start(va_list ap, last);
type va_arg(va_list ap, type);
void va_end(va_list ap);
void va_copy(va_list dest, va_list src);
void va_start(va_list ap, last);
va_start用于初始化变参结构ap,其中va_list是与变参列表相关的结构,里面保存着变参列表的信息包括变参列表的指针。
last是变参函数的可变参数列表的前一个参数,用于确定可变参数的内存地址;
type va_arg(va_list ap, type);
va_arg取出当前的参数用于返回,并且把变参列表指针指向下一个参数。其中ap是经过va_start初始化的变参结构,type是变参的类型。
void va_end(va_list ap);
va_end用于结束对可变参数的获取,释放相应的资源,将ap清零。va_end和va_start成对使用。
void va_copy(va_list dest, va_list src);
用于复制变参结构。由于具体实现不同,变参结构本身或是结构里面的参数时指针,而简单的赋值操作会造成浅拷贝,
当其中一个结构的指针被释放空间的时候(va_end释放空间),另一个结构的指针会成为野指针,可能就会出问题,所以对于va_list型的变量来说,禁止直接赋值(=),要用va_copy进行拷贝。
3.用法:
a.首先在函数里定义一具va_list型的变量:
b.然后用va_start宏初始化变量刚定义的va_list变量,这个宏的第二个参数是第一个可变参数的前一个参数,是一个固定的参数。
c.然后用va_arg返回可变的参数,va_arg的第二个参数是你要返回的参数的类型。如果函数有多个可变参数的,依次调用va_arg获取各个参数。
d.最后用va_end宏结束可变参数的获取。
4.例子:
#include <stdio.h>
#include <stdarg.h>
void foo(char *fmt, ...)
{
va_list ap;
int d;
char c, *s;
va_start(ap, fmt);
while (*fmt)
switch (*fmt++)
{
case 's': /* string */
s = va_arg(ap, char *);
printf("string %s\n", s);
break;
case 'd': /* int */
d = va_arg(ap, int);
printf("int %d\n", d);
break;
case 'c': /* char */
/* need a cast here since va_arg only
takes fully promoted types */
c = (char) va_arg(ap, int);
printf("char %c\n", c);
break;
}
va_end(ap);
}
5.使用VA_LIST应该注意的问题:
a.可变参数的类型和个数完全由程序代码控制,它并不能智能地识别不同参数的个数和类型;
b.由于各个平台对va_list的实现可能会用不同,所以严格的通过va_start、va_arg、va_end、va_copy来使用va_list很有必要,不建议直接对其进行指针操作;
c.因为编译器对可变参数的函数的原型检查不够严格,对编程查错不利。不利于我们写出高质量的代码;
d.va_start,va_arg,va_end是在C89标准中定义的。va_copy是在C99标准中定义的。
参考:
http://hi.baidu.com/kangliang/item/aa6ba5a94e82299f151073bd
http://www.cppblog.com/xmoss/archive/2009/07/20/90680.html