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是与变参列表相关的结构,里面保存着变参列表的信息包括变参列表的指针。
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);用于复制变参结构。由于具体实现不同,变参结构本身或是结构里面的参数时指针,而简单的赋值操作会造成浅拷贝,
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); }
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