允许调用函数时不提供一个或多个尾部的实参。

通过为函数声明的 形参列表 中的形参使用下列语法来指定默认实参。

attr(可选) 声明说明符序列 声明符 = 初始化器 (1)
attr(可选) 声明说明符序列 抽象声明符(可选) = 初始化器 (2)

默认实参用于取代函数调用中缺失的尾部实参:

  1. void point(int x = 3, int y = 4);
  2.  
  3. point(1,2); // 调用 point(1,2)
  4. point(1); // 调用 point(1,4)
  5. point(); // 调用 point(3,4)

在函数声明中,在拥有默认实参的形参之后,所有后续形参必须

  • 拥有在这个或同一作用域中先前的声明中所提供的默认实参;或
  1. int x(int = 1, int); // 错误,假定没有先前的 x 的声明
  2.  
  3. void f(int n, int k = 1);
  4. void f(int n = 0, int k); // OK:同一作用域中之前的声明为 k 提供了默认实参
  5.  
  6. void g(int, int = 7);
  7. void h() {
  8. void g(int = 1, int); // 错误:不在同一作用域
  9. }


-
- …除非该形参是从某个形参包展开得到的




  1. template<class T> struct C { void f(int n = 0, T…); };
    C<int> c; // OK;实例化了声明 void C::f(int n = 0, int)





- 或者是函数形参包。




  1. template<classT> void h(int i = 0, T args); // ok



(C++11 起)

省略号不是形参,故可以跟在带有默认实参的形参之后。

  1. int g(int n = 0, ...); // ok

默认实参仅允许于函数声明lambda 表达式 (C++14 起)的形参列表中出现,而不允许在函数指针、到函数的引用,或在 typedef 声明中出现。模板形参列表为其默认模板实参使用了类似的语法。

对于非模板函数,当在同一作用域中重声明函数时,可以向已声明的函数添加默认实参。在函数调用点,可用的默认实参是由该函数所有可见的声明中所提供的默认实参的并集。重声明不能为已有可见默认值的实参引入默认值(即使值相同)。内层作用域中的重声明不从外层作用域获得默认实参。

  1. void f(int, int); // #1
  2. void f(int, int = 7); // #2 OK :添加到默认
  3.  
  4. void h() {
  5. f(3); // #1 与 #2 在作用域中;进行对 f(3,7) 的调用
  6. void f(int =1, int); // 错误:内层作用域声明不获得默认实参
  7. }
  8.  
  9. void m() { // 新作用域开始
  10. void f(int, int); // 内层作用域声明;无默认实参。
  11. f(4); // 错误:调用 f(int, int) 的实参不足
  12. void f(int, int = 6);
  13. f(4); // OK:调用 f(4,6);
  14. void f(int, int = 6); // 错误:不能在同一作用域中重声明默认实参
  15. }
  16.  
  17. void f(int = 1, int); // #3 OK,向 #2 添加默认实参
  18.  
  19. void n() { // 新作用域开始
  20. f(); // #1、#2 及 #3 在作用域中:调用 f(1, 7);
  21. }

若某个 inline 函数声明于不同翻译单元中,则默认实参的积累集必须在每个翻译单元的结尾相同。


若在不同翻译单元的同一命名空间作用域中声明一个非 inline 函数,则对应的默认实参若存在则必须相同(但一些某些翻译单元中可以缺少一些默认实参)。
(C++20 起)

friend 声明指定了默认实参,则它必须是友元函数定义,且该翻译单元中不允许此函数的其他声明。

using 声明将已知的默认实参集承接过来,且若向函数的命名空间中添加更多默认形参,则这些默认实参在这条 using 声明可见的任何位置均亦为可见

  1. namespace N {
  2. void f(int, int = 1);
  3. }
  4. using N::f;
  5. void g() {
  6. f(7); // 调用 f(7, 1);
  7. f(); // 错误
  8. }
  9. namespace N {
  10. void f(int = 2, int);
  11. }
  12. void h() {
  13. f(); // 调用 f(2, 1);
  14. }

对默认实参中使用的名字进行查找,检查可访问性,并绑定于声明点,但在函数调用点才执行:

  1. int a = 1;
  2. int f(int);
  3. int g(int x = f(a)); // f 的查找找到 ::f,a 的查找找到 ::a
  4. // 不使用 ::a 的值,它在此点为 1
  5. void h()
  6. {
  7. a = 2; // 更改 ::a 的值
  8. {
  9. int a = 3;
  10. g(); // 调用 f(2),然后以结果调用 g()
  11. }
  12. }

对于非模板类的成员函数,类外的定义中允许出现默认实参,并与类体内的声明所提供的默认实参组合。若类外的默认实参会使成员函数变成默认、复制或移动构造函数,则程序非良构。对于类模板的成员函数,所有默认实参必须在成员函数的初始声明处提供。

  1. class C {
  2. void f(int i = 3);
  3. void g(int i, int j = 99);
  4. C(int arg); // 非默认构造函数
  5. };
  6. void C::f(int i = 3) { // 错误:默认实参已指定于类作用域
  7. }
  8. void C::g(int i = 88, int j) { // OK:此翻译单元中,可无实参调用 C::g
  9. }
  10. C::C(int arg = 1) { // 错误:使之变成了默认构造函数
  11. }

函数的覆盖函数不会从基类定义获得默认实参,而在进行虚函数调用时,默认实参根据对象的静态类型确定(注意:这可以通过非虚接口模式避免)。

  1. struct Base {
  2. virtual void f(int a = 7);
  3. };
  4. struct Derived : Base {
  5. void f(int a) override;
  6. };
  7. void m() {
  8. Derived d;
  9. Base& b = d;
  10. b.f(); // OK:调用 Derived::f(7)
  11. d.f(); // 错误:无默认实参
  12. }

默认实参中不允许使用局部变量,除非用于不求值语境中 (C++14 起):

  1. void f()
  2. {
  3. int n = 1;
  4. extern void g(int x = n); // 错误:局部变量不能为默认
  5. extern void h(int x = sizeof n); // CWG 2082 起 OK
  6. }

默认实参中不允许 this 指针:

  1. class A {
  2. void f(A* p = this) { } // 错误:不允许 this
  3. };

默认实参中不允许使用非静态的类成员(即使它们不被求值),除非用于构成成员指针或在成员访问表达式中使用。

  1. int b;
  2. class X {
  3. int a;
  4. int mem1(int i = a); // 错误:不能使用非静态数据成员
  5. int mem2(int i = b); // OK:查找找到静态成员 X::b
  6. static int b;
  7. };

默认实参中不允许使用函数形参(即使它们不被求值) (C++14 前)除非它们不被求值 (C++14 起)。注意,形参列表中较早出现的形参已在作用域中:

  1. int a;
  2. int f(int a, int b = a); // 错误:形参用作默认实参
  3. int g(int a, int b = sizeof a); // CWG 2082 为止错误
  4. // CWG 2082 后 OK:用于不求值语境是 OK 的

默认实参不是函数类型的一部分

  1. int f(int = 0);
  2. void h() {
  3. int j = f(1);
  4. int k = f(); // 调用 f(0);
  5. }
  6. int (*p1)(int) = &f;
  7. int (*p2)() = &f; // 错误:f 的类型是 int(int)

lambda 表达式出现于默认实参中,则它不能显式或隐式俘获任何内容。

  1. void f2() {
  2. int i = 1;
  3. void g1(int = ([i]{ return i; })()); // 错误:俘获某些内容
  4. void g2(int = ([i]{ return 0; })()); // 错误:俘获某些内容
  5. void g3(int = ([=]{ return i; })()); // 错误:俘获某些内容
  6. void g4(int = ([=]{ return 0; })()); // OK:无俘获
  7. void g5(int = ([]{ return sizeof i; })()); // OK:无俘获
  8. }

除了函数调用运算符外,运算符函数不应有默认参数。

  1. class C {
  2. int operator[](int i = 0); // 非良构
  3. int operator()(int x = 0); // ok
  4. };

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR 应用于 出版时的行为 正确行为
CWG 2082 C++14 曾禁止默认实参在不求值语境中使用局部变量 允许不求值语境的使用