©
本文档使用 PHP中文网手册 发布
变量函数是可以用不同数量的参数调用的函数。
只有新式(原型)函数声明可能是可变的。这由...
必须出现在参数列表中的最后一个格式的参数表示,并且必须至少跟随一个命名参数。
//New-style declarationint printx(const char* fmt, ...); // function declared this wayprintx("hello world"); // may be called with oneprintx("a=%d b=%d", a, b); // or more arguments // int printy(..., const char* fmt); // Error: ... must be the last// int printz(...); // Error: ... must follow at least one named parameter
在函数调用中,作为变量参数列表一部分的每个参数都会经历特殊的隐式转换,称为默认参数促销。
在使用可变参数的函数体内,可以使用<stdarg.h>库函数来访问这些参数的值:
| Defined in header <stdarg.h> |
|:----|
| va_start | 允许访问可变参数函数参数(函数宏)|
| va_arg | 访问下一个可变参数函数参数(函数宏)|
| va_copy(C99)| 制作可变参数函数参数(函数宏)|的副本
| va_end | 结束可变参数函数参数(函数宏)|的遍历
| va_list | 保存va_start,va_arg,va_end和va_copy(typedef)所需的信息|
虽然旧式(无原型)函数声明允许后续函数调用使用任意数量的参数,但它们不允许为可变参数(从C89开始)。这种函数的定义必须指定一个固定数量的参数,并且不能使用这些stdarg.h
宏。
//old-style declarationint printx(); // function declared this wayprintx("hello world"); // may be called with oneprintx("a=%d b=%d", a, b); // or more arguments// the behavior of one of these calls is undefined, depending on// whether the function is defined to take 1 or 3 parameters
#include <stdio.h>#include <time.h>#include <stdarg.h> void tlog(const char* fmt,...){ char msg[50]; strftime(msg, sizeof msg, "%T", localtime(&(time_t){time(NULL)})); printf("[%s] ", msg); va_list args; va_start(args, fmt); vprintf(fmt, args); va_end(args);} int main(void){ tlog("logging %d %d %d...\n", 1, 2, 3);}
输出:
[10:21:38] logging 1 2 3...
C11标准(ISO / IEC 9899:2011):
6.7.6.3/9函数声明符(包括原型)(p:133)
7.16变量参数<stdarg.h>(p:269-272)
C99标准(ISO / IEC 9899:1999):
6.7.5.3/9函数声明符(包括原型)(p:119)
7.15变量参数<stdarg.h>(p:249-252)
C89 / C90标准(ISO / IEC 9899:1990):
3.5.4.3/5函数声明符(包括原型)
4.8变量<stdarg.h>