C 标准库 - <stdarg.h>
<stdarg.h> 是 C 标准库中的一个头文件,提供了一组宏,用于访问可变数量的参数。
stdarg.h 头文件定义了一个变量类型 va_list 和三个宏,这三个宏可用于在参数个数未知(即参数个数可变)时获取函数中的参数。
可变参数的函数通在参数列表的末尾是使用省略号 ... 定义的。
库变量
下面是头文件 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,则结果为未定义。 |
实例
以下是一个使用 <stdarg.h> 实现可变参数函数的示例。该函数计算所有参数的总和:
实例
#include <stdio.h>
#include <stdarg.h>
// 计算可变参数的和
int sum(int count, ...) {
int total = 0;
va_list args;
// 初始化 args 以访问可变参数
va_start(args, count);
// 逐个访问可变参数
for (int i = 0; i < count; i++) {
total += va_arg(args, int);
}
// 清理 args
va_end(args);
return total;
}
int main() {
printf("Sum of 1, 2, 3: %d\n", sum(3, 1, 2, 3)); // 输出 6
printf("Sum of 4, 5, 6, 7: %d\n", sum(4, 4, 5, 6, 7)); // 输出 22
return 0;
}
#include <stdarg.h>
// 计算可变参数的和
int sum(int count, ...) {
int total = 0;
va_list args;
// 初始化 args 以访问可变参数
va_start(args, count);
// 逐个访问可变参数
for (int i = 0; i < count; i++) {
total += va_arg(args, int);
}
// 清理 args
va_end(args);
return total;
}
int main() {
printf("Sum of 1, 2, 3: %d\n", sum(3, 1, 2, 3)); // 输出 6
printf("Sum of 4, 5, 6, 7: %d\n", sum(4, 4, 5, 6, 7)); // 输出 22
return 0;
}
输出结果:
Sum of 1, 2, 3: 6 Sum of 4, 5, 6, 7: 22
解析
va_list args;:声明一个va_list变量,用于访问可变参数。va_start(args, count);:初始化args以遍历可变参数列表,从count之后的第一个参数开始。total += va_arg(args, int);:获取可变参数列表中的下一个参数,并将其累加到total中。参数类型为int。va_end(args);:清理args。
注意事项
- 可变参数列表中的每个参数类型必须明确,且必须一致地传递给
va_arg。 - 使用
va_start后,必须使用va_end清理va_list变量。 va_start、va_arg和va_end宏在一个函数中应成对使用,以避免未定义行为。
