Variadic arguments

允许函数接受任意数量的额外参数。

当函数的 参数列表 中最后一个参数是省略号（ ... ）时，该函数为可变参数函数。

// 函数声明如下
int printx(const char* fmt, ...);
int printx(const char* fmt...); // 与上述相同，但自 C++26 起已弃用
// 可使用一个或多个参数调用：
printx("hello world");
printx("a=%d b=%d", a, b);
int printy(..., const char* fmt); // 错误：... 只能是最后一个参数
int printz(...); // 有效，但无法以可移植方式访问参数

默认参数提升

当调用可变参数函数时，在经历左值到右值、数组到指针和函数到指针 转换 后，属于可变参数列表的每个参数还会进行额外的转换，称为 默认参数提升 ：

• float 参数会按照 浮点提升 规则转换为 double 。
• bool 、 char 、 short 及无作用域枚举类型会按照 整型提升 规则转换为 int 或更宽的整数类型。

非POD类类型 (C++11前) 具有合格非平凡复制构造函数、合格非平凡移动构造函数或非平凡析构函数的作用域枚举和类类型 (C++11起) 在具有实现定义语义的潜在求值调用中为有条件支持（这些类型在 不求值调用 中始终受支持）。

由于可变参数在 重载解析 中具有最低优先级，它们通常被用作 SFINAE 中的全能后备方案。

在使用可变参数的函数体内，可以通过 <cstdarg> 库工具 访问这些参数的值：

若省略号前的最后一个参数具有引用类型，或其类型与 默认参数提升 后的类型不兼容，则 va_start 宏的行为是未定义的。

替代方案

注释

在C语言中，直到C23标准之前，省略号参数前必须至少出现一个命名参数，因此 R printz ( ... ) ; 在C23之前是无效的。在C++中，即使传递给此类函数的参数不可访问，这种形式也是被允许的，并且通常用作 SFINAE 中的备选重载，利用省略号转换在 重载解析 中的最低优先级特性。

这种可变参数语法于1983年在C++中引入时，省略号前没有逗号。当C89从C++引入函数原型时，将其替换为要求逗号的语法。为保持兼容性，C++98同时接受C++风格的 f ( int n... ) 和C风格的 f ( int n, ... ) 。原始C++风格语法自C++26起被弃用。

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参阅