stdarg.h

stdarg.h是C语言中C标准函数库的头文件，stdarg是由standard（标准） arguments（参数）简化而来，主要目的为让函数能够接收可变参数。C++的cstdarg头文件中也提供这样的功能；虽然与C的头文件是兼容的，但是也有冲突存在。

可变参数函数(Variadic functions)是stdarg.h内容典型的应用，虽然也可以使用在其他由可变参数函数调用的函数(例如， vprintf)。

可变参数函数

声明可变参数函数

可变参数函数的参数数量是可变动的，它使用省略号来忽略之后的参数。例如 printf函数一般。代表性的声明为：

int check(int a, double b, ...);

可变参数函数最少要有一个命名的参数，所以

char *wrong(...)；

在C中是不被允许的(在C++中，这样的声明是合理的)。C中，省略符号之前必须要有逗号；而在C++中，则没有这种强制要求。

定义可变参数函数

使用相同的语法来定义：

long func(char, double, int, ...);

long func(char a, double b, int c, ...)

{

/* ... */

}

在C的旧形式中可能会出现较省略的函数定义：

long func();

char a;

double b;

long func(a, b, c, ...)

{

/* ... */

}

成员

stdarg.h数据类型

类型名称	描述	相容
va_list	用来保存宏va_arg与宏va_end所需信息	C89

stdarg.h宏 巨集名称	描述	相容
va_start	使va_list指向起始的参数	C89
va_arg	检索参数	C89
va_end	释放va_list	C89
va_copy	拷贝va_list的内容	C99

访问参数

访问未命名的参数，首先必须在可变参数函数中声明va_list类型的变量。调用 va_start并传入两个参数：第一个参数为va_list类型的变量，第二个为省略号前最后一个有名字的参数的名称，接着每一调用va_arg就会返回下一个参数，va_arg的第一个参数为va_list，第二个参数为返回的类型。最后va_end必须在函数返回前被va_list调用(va_list当作参数)(没有要求要读取完所有参数)。

C99提供额外的宏，va_copy，它能够复制va_list。而va_copy(va2, va1)函数作用为拷贝va1到va2。

没有机制定义该怎么判别传递到函数的参数量或者数据类型。函数通常需要知道或确定它们变化的方法。共通的惯例包含:

使用printf或 scanf类的格式化字串来嵌入明确指定的类型。

在可变参数最后的标记值(sentinel value)。

总数变量来指明可变参数的数量。

例子

#include <stdio.h>

#include <stdarg.h>

void printargs(int arg1, ...) /* 输出所有int类型的参数，直到-1结束 */

{

va_list ap;

int i;

va_start(ap, arg1);

for (i = arg1; i != -1; i = va_arg(ap, int))

printf("%d ", i);

va_end(ap);

putchar('\n');

}

int main(void)

{

printargs(5, 2, 14, 84, 97, 15, 24, 48, -1);

printargs(84, 51, -1);

printargs(-1);

printargs(1, -1);

return 0;

}

这个程序产生输出：

5 2 14 84 97 15 24 48

84 51

1