例如可变参函数printf的函数原型/函数声明为:int printf(char *fmt, ...);
其中参数表必须至少包括一个有名参数(如fmt);省略号表示参数表中参数的数量和类型是可变的,且省略号只能出现在参数表的尾部。
在标准头文件<stdarg.h>
中包含一组宏定义,它们对如何遍历未知数目和类型的函数参数表进行了定义;该头文件的实现因不同的机器而不同,但提供的接口是一致的。主要的宏如下:
void va_start(va_list ap,lastarg);
type va_arg(va_list ap,type);
void va_end(va_list ap);
- va_list: va_list类型用于声明一个变量ap,该变量将依次引用变长参数列表中各参数,定义为
typedef char *va_list
。 - va_start:宏va_start将ap初始化为指向第一个无名参数;lastarg为最后一个有名参数。
- va_arg:va_arg将返回ap指向的参数,并将ap指向下一个参数;va_arg使用一个类型名(type)来决定返回的对象类型、ap移动的步长。
- va_end:最后必须在函数返回前调用va_end,以完成一些必要的清理工作。(va:variable argument)
- 在没有函数原型的情况下,char与short类型都将转换为int类型;float类型将被转换为double类型。实际上,用
...
标识的可变参总是会执行这种类型提升(Type Promotions)。
一个简单可变参数函数:
#include<stdio.h>
#include<stdarg.h>
void f(char *fmt, ...);
int main(void)
{
printf("f is a variable argument function \n");
f("%s,%s,%s,%s,%s,%s","f","is","a","variable","argument","function");
return 0;
}
void f(char *fmt, ...)
{
va_list ap; /*声明一个引用变长参数的变量*/
va_start(ap,fmt); /*将ap初始化为指向第一个无名参数*/
int i=1;
char *p=fmt;
while(*p){
if('%'==*p && 's'==*(p+1))
printf("%s is #%d parameter\n",va_arg(ap,char *),++i); /*va_arg将返回ap指向的参数,并将ap指向下一个参数*/
p++;
}
va_end(ap); /*函数返回前调用va_end*/
}