stdarg.h 头文件定义了一个变量类型 va_list 和三个宏,这三个宏可用于在参数个数未知(即参数个数可变)时获取函数中的参数。之前在讲C语言可变参数的时候用到了这个(C语言变参数函数详解)。
可变参数的函数通在参数列表的末尾是使用省略号(,…)定义的。
库变量
下面是头文件 stdarg.h 中定义的变量类型:
序号 | 变量 & 描述 |
---|---|
1 | va_list 这是一个适用于 va_start()、va_arg() 和 va_end() 这三个宏存储信息的类型。 |
库宏
下面是头文件 stdarg.h 中定义的宏:
序号 | 宏 & 描述 |
---|---|
1 | void va_start(va_list ap, last_arg) 这个宏初始化 ap 变量,它与 va_arg 和 va_end 宏是一起使用的。last_arg 是最后一个传递给函数的已知的固定参数,即省略号之前的参数。 |
2 | type va_arg(va_list ap, type) 这个宏检索函数参数列表中类型为 type 的下一个参数。 |
3 | void va_end(va_list ap) 这个宏允许使用了 va_start 宏的带有可变参数的函数返回。如果在从函数返回之前没有调用 va_end,则结果为未定义。 |
C 库宏 va_start() 使用方法及示例
C 库宏 void va_start(va_list ap, last_arg) 初始化 ap 变量,它与 va_arg 和 va_end 宏是一起使用的。last_arg 是最后一个传递给函数的已知的固定参数,即省略号之前的参数。
这个宏必须在使用 va_arg 和 va_end 之前被调用。
声明
下面是 va_start() 宏的声明。
void va_start(va_list ap, last_arg);
参数
- ap – 这是一个 va_list 类型的对象,它用来存储通过 va_arg 获取额外参数时所必需的信息。
- last_arg – 最后一个传递给函数的已知的固定参数。
返回值
NA
在线示例
下面的示例演示了 va_start() 宏的用法。
#include<stdarg.h>
#include<stdio.h>
int sum(int, ...);
int main(void)
{
printf("210, 70, 90 的和 = %d\n", sum(3, 210, 70, 90));
printf("5, 15, 34, 50 的和 = %d\n", sum(4, 5, 15, 34, 50));
return 0;
}
int sum(int num_args, ...)
{
int val = 0;
va_list ap;
int i;
va_start(ap, num_args);
for (i = 0; i < num_args; i++)
{
val += va_arg(ap, int);
}
va_end(ap);
return val;
}
让我们编译并运行上面的程序,这将产生以下结果:
210, 70, 90 的和 = 370
5, 15, 34, 50 的和 = 104
C 库宏 va_arg() 使用方法及示例
C 库宏 type va_arg(va_list ap, type) 检索函数参数列表中类型为 type 的下一个参数。它无法判断检索到的参数是否是传给函数的最后一个参数。
声明
下面是 va_arg() 宏的声明。
type va_arg(va_list ap, type)
参数
- ap – 这是一个 va_list 类型的对象,存储了有关额外参数和检索状态的信息。该对象应在第一次调用 va_arg 之前通过调用 va_start 进行初始化。
- type – 这是一个类型名称。该类型名称是作为扩展自该宏的表达式的类型来使用的。
返回值
该宏返回下一个额外的参数,是一个类型为 type 的表达式。
在线示例
下面的示例演示了 va_arg() 宏的用法。
#include <stdarg.h>
#include <stdio.h>
int sum(int, ...);
int main()
{
printf("10 和 34 的和 = %d\n", sum(2, 10, 34) );
return 0;
}
int sum(int num_args, ...)
{
int val = 0;
va_list ap;
int i;
va_start(ap, num_args);
for(i = 0; i < num_args; i++)
{
val += va_arg(ap, int);
}
va_end(ap);
return val;
}
让我们编译并运行上面的程序,这将产生以下结果:
10 和 34 的和 = 44
C 库宏 va_end() 使用方法及示例
C 库宏 void va_end(va_list ap) 允许使用了 va_start 宏的带有可变参数的函数返回。如果在从函数返回之前没有调用 va_end,则结果为未定义。
声明
下面是 va_end() 宏的声明。
void va_end(va_list ap)
参数
- ap – 这是之前由同一函数中的 va_start 初始化的 va_list 对象。
返回值
该宏不返回任何值。
在线示例
下面的示例演示了 va_end() 宏的用法。
#include <stdarg.h>
#include <stdio.h>
int mul(int, ...);
int main()
{
printf("10 * 100 = %d\n", mul(2, 10, 100) );
return 0;
}
int mul(int num_args, ...)
{
int val = 1;
va_list ap;
int i;
va_start(ap, num_args);
for(i = 0; i < num_args; i++)
{
val *= va_arg(ap, int);
}
va_end(ap);
return val;
}
让我们编译并运行上面的程序,这将产生以下结果:
10 * 100 = 1000