stdarg.h

 

stdarg.h是C语言中C标准函数库的头文件，stdarg是由stdandard(标准) 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, ...)
{
    /* ... */
}

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

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因为运作的模式需要旧型态的函数定义。