stdarg.h

原文：http://baike.baidu.com/view/3373010.htm

 

stdarg.h
　　stdarg.h是C语言中C标准函式库的标头档，stdarg是由standard(标准) arguments(参数)简化而来，主要目的为让函式能够接收不定量参数。[1] 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, ...)
　　{
　　/* ... */
　　}
　　在旧形式可能会出现较省略的函式定义:
　　long func();
　　long func(a, b, c, ...)
　　char a;
　　double b;
　　{
　　/* ... */
　　}
　　stdarg.h型态名称 描述 相容
　　va_list 用来指向参数 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呼叫(当作参数)。(没有要求要读取完所有参数)
　　C99提供额外的巨集，va_copy，它能够复制va_list。而va_copy(va2, va1)意思为拷贝va1到va2。
　　没有机制定义该怎么判别传递到函式的参数量或者型态。函式通常需要知道或确定它们变化的方法。共通的惯例包含:
　　使用printf或scanf类的格式化字串来嵌入明确指定的型态。
　　在不定参数最后的标兵值(sentinel value)。
　　总数变数来指明不定参数的数量。
　　型别安全性
　　有些C工具将C扩充允许编译器检查适当格式化字串及标兵(sentinels)的使用。如果没有这个扩充，编译器通常无从检查传入函式的未命名参数是否为所预期的型态。因此，必须对点做出谨慎的正确性确认，型态没有吻合为未定义行为(Undefined behavior)。举个例，如果传入NULL指标，首先就是不能写入对应到适当指标型态但纯粹NULL的指标。再者考虑预设参数应用到未命名参数。float将会自动的被转换成double?同样的比int(整数)更小容量的参数型态将会被转换成int或者unsigned int?函式所接收到的未命名参数必须预期到会被转换型态。
　　例子
　　#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
　　varargs.h
　　POSIX定义所遗留下的标头档varargs.h，它早在C标准化前就已经开始使用了且提供类似stdarg.h的机能。这个标头档不属于ISO C的一部分。档案定义在单使用者UNIX系统规范(Single UNIX Specification)的第二个版本中，简单的包含所有C89 stdarg.h的机能，除了:不能使用在标准C较新的形式定义；你可以不给予参数(标准C需要最少一个参数)；与标准C运作的方法不同，其中一个写成：
　　#include <stdarg.h>
　　int summate(int n, ...)
　　{
　　va_list ap;
　　int i = 0;
　　va_start(ap, n);
　　for (; n; n--)
　　i += va_arg(ap, int);
　　va_end(ap);
　　return i;
　　}
　　或比较旧式的定义:
　　#include <stdarg.h>
　　int summate(n, ...)
　　int n;
　　{
　　/* ... */
　　}
　　以此呼叫
　　summate(0);
　　summate(1, 2);
　　summate(4, 9, 2, 3, 2);
　　使用varargs.h的函式为:
　　#include <varargs.h>
　　summate(n, va_alist)
　　va_dcl /* 这里没有分号! */
　　{
　　va_list ap;
　　int i = 0;
　　va_start(ap);
　　for (; n; n--)
　　i += va_arg(ap, int);
　　va_end(ap);
　　return i;
　　}
　　以及相同的呼叫方法。
　　varargs.h因为运作的模式需要旧型态的函式定义。[2]
　　参考
　　^ IEEE Std 1003.1 stdarg.h．于2009年7月4日查阅．
　　^ 单使用者UNIX系统规范(Single UNIX Specification) varargs.h．于2007年8月1日查阅．
　　1个分类: C标准函式库