va_start

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

可变参数函数

va_start

va_arg

va_copy (C99)

va_end

va_list

 

定义于头文件 <stdarg.h>
void va_start( va_list ap, parmN );		(C23 前)
void va_start( va_list ap, ... );		(C23 起)

va_start 宏启用对命名参数 parmN 之后的变量参数的访问 following the named argument parmN(C23 前)。

va_start 应当在任何调用 va_arg 之前，使用有效的 va_list 对象 ap 的实例来调用。

如果 parmN 被声明为带有 register 存储类说明符、数组类型、函数类型，或与默认参数提升产生的类型不兼容的类型，则行为未定义。	(C23 前)
只有传递给 va_start 的第一个参数会被求值。任何额外的参数既不会被展开，也不会以任何方式使用。	(C23 起)

参数

ap	-	va_list 类型的实例
parmN	-	位于首个可变参数之前的已命名参数

展开值

（无）

示例

运行此代码

#include <stdio.h>
#include <stdarg.h>
 
int add_nums_C99(int count, ...)
{
    int result = 0;
    va_list args;
    va_start(args, count); // count can be omitted since C23
 
    for (int i = 0; i < count; ++i) {
        result += va_arg(args, int);
    }
 
    va_end(args);
    return result;
}
 
#if __STDC_VERSION__ > 201710L
// Same as above, valid since C23
int add_nums_C23(...)
{
    int result = 0;
    va_list args;
    va_start(args);
 
    int count = va_arg(args, int);
    for (int i = 0; i < count; ++i) {
        result += va_arg(args, int);
    }
 
    va_end(args);
    return result;
}
#endif
 
int main(void)
{
    printf("%d\n", add_nums_C99(4, 25, 25, 50, 50));
#if __STDC_VERSION__ > 201710L
    printf("%d\n", add_nums_C23(4, 25, 25, 50, 50));
#endif
}

可能的输出

150
150

参考

• C17 标准 (ISO/IEC 9899:2018)

• 7.16.1.4 va_start 宏 (页: 198-199)

• C11 标准 (ISO/IEC 9899:2011)

• 7.16.1.4 va_start 宏 (页: 271-272)

• C99 标准 (ISO/IEC 9899:1999)

• 7.15.1.4 va_start 宏 (页: 251-252)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.8.1.1 va_start 宏

参见

va_arg	访问下一个可变参数函数参数 (函数宏)
va_copy (C99)	复制可变参数函数参数 (函数宏)
va_end	结束可变参数函数参数的遍历 (函数宏)
va_list	保存 va_start、va_arg、va_end 和 va_copy 所需的信息 (类型定义)
C++ 文档 for va_start