【valist】c语言可变参数宏

va_list 是C语言中解决变参问题的一组宏。

1.API介绍：
头文件：

[cpp]  view plain  copy

 print ?

1. #include <stdarg.h>  

下面是实现变参函数的一组宏（macro）：

[cpp]  view plain  copy

 print ?

1. void va_start(va_list ap, last);  
2. type va_arg(va_list ap, type);  
3. void va_end(va_list ap);  
4. void va_copy(va_list dest, va_list src);  

2.具体介绍：

[cpp]  view plain  copy

 print ?

1. void va_start(va_list ap, last);  

va_start用于初始化变参结构ap，其中va_list是与变参列表相关的结构，里面保存着变参列表的信息包括变参列表的指针。
last是变参函数的可变参数列表的前一个参数，用于确定可变参数的内存地址；

[cpp]  view plain  copy

 print ?

1. type va_arg(va_list ap, type);  

va_arg取出当前的参数用于返回，并且把变参列表指针指向下一个参数。其中ap是经过va_start初始化的变参结构，type是变参的类型。

[cpp]  view plain  copy

 print ?

1. void va_end(va_list ap);  

va_end用于结束对可变参数的获取，释放相应的资源，将ap清零。va_end和va_start成对使用。

[cpp]  view plain  copy

 print ?

1. 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.例子：

[html]  view plain  copy

 print ?

1. #include <stdio.h>  
2. #include <stdarg.h>  
3.   
4. void foo(char *fmt, ...)  
5. {  
6.     va_list ap;  
7.     int d;  
8.     char c, *s;  
9.   
10.     va_start(ap, fmt);  
11.     while (*fmt)  
12.     switch (*fmt++)   
13.     {  
14.         case 's':              /* string */  
15.             s = va_arg(ap, char *);  
16.             printf("string %s\n", s);  
17.             break;  
18.         case 'd':              /* int */  
19.             d = va_arg(ap, int);  
20.             printf("int %d\n", d);  
21.             break;  
22.         case 'c':              /* char */  
23.             /* need a cast here since va_arg only  
24.             takes fully promoted types */  
25.             c = (char) va_arg(ap, int);  
26.             printf("char %c\n", c);  
27.             break;  
28.     }  
29.     va_end(ap);  
30. }  

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标准中定义的。