指定函数是否抛出异常。
语法
noexcept | (1) | |
noexcept( 表达式) | (2) | |
throw() | (3) | (弃用)(C++20 中移除) |
1) 与 noexcept
(
true
)
相同
2) 若 表达式 求值为 true,则声明函数为不抛出任何异常。
3) 与 noexcept(true) 相同 | (C++17 起)(C++20 前) |
3) 不抛出动态异常说明(不同于 noexcept(true),它保证进行栈回溯并可能调用 std::unexpected) | (C++17 前) |
表达式 | - | 按语境转换为 bool 类型的常量表达式 |
解释
noexcept 说明是函数类型的一部分,可以作为任何函数声明符的一部分出现。 | (C++17 起) |
noexcept 说明不是函数类型的一部分(正如同动态异常说明),而且只能在声明函数、变量、函数类型的非静态数据成员、函数指针、函数引用或成员函数指针时,以及在以上这些声明中声明类型为函数指针或函数引用的形参或返回类型时,作为 lambda 声明符或顶层函数声明符的一部分出现。它不能出现于 typedef 或类型别名声明中。
| (C++17 前) |
C++ 中的每个函数,或为不抛出,或为潜在抛出。
- 潜在抛出的函数是:
- - 说明时带有动态异常说明的函数。 | (C++17 前) |
- - - 在其首个声明被预置的比较运算符,除非其隐式定义中对任何比较运算符的调用为潜在抛出(见下文) | (C++20 起) |
- 不抛出函数为所有其他函数(以 表达式 求值为
true
的 noexcept 说明符声明的函数,以及析构函数、预置的特殊成员函数和解分配函数)
显式实例化可使用 noexcept 说明符,但不要求。若使用,则其异常说明必须与所有其他声明相同。仅当其异常说明在同一翻译单元中不相同时,才要求诊断。
仅于异常说明有别的函数不能重载(与返回类型相似,异常说明是函数类型的一部分,但不是函数签名的一部分) (C++17 起)。
- void f() noexcept;
- void f(); // 错误:不同的异常说明
- void g() noexcept(false);
- void g(); // ok,g 的两个声明均为潜在抛出
指向不抛出函数的指针可隐式转换为 (C++17 起)可赋值给 (C++17 前)指向潜在抛出函数的指针,但反之不可。
- void ft(); // 潜在抛出
- void (*fn)() noexcept = ft; // 错误
若虚函数为不抛出,则其每个覆盖函数的所有声明(包括定义)都必须是不抛出的,除非覆盖函数被定义为弃置:
- struct B {
- virtual void f() noexcept;
- virtual void g();
- virtual void h() noexcept = delete;
- };
- struct D: B {
- void f(); // 非良构:D::f 为潜在抛出,B::f 为不抛出
- void g() noexcept; // OK
- void h() = delete; // OK
- };
不抛出函数允许调用潜在抛出函数。每当抛出异常且对处理块的查找遇到了不抛出函数的最外层块时,就调用函数 std::terminate:
- extern void f(); // 潜在抛出
- void g() noexcept {
- f(); // 合法,即使 f 抛出
- throw 42; // 合法,等效于调用 std::terminate
- }
函数模板特化的异常说明不随函数声明而实例化;它仅在需要(定义如下)时实例化。 隐式声明的特殊成员函数的异常说明亦只在需要时求值(特别是,派生类成员函数的隐式声明不要求实例化基类成员函数的异常说明) 在需要但尚未实例化某个函数模板特化的 noexcept 说明时,如同对该特化的声明一样,对待决名进行查找并实例化 表达式 中所用的任何模板。 在下列语境中认为需要函数的 noexcept 说明 - 在表达式中,该函数已被重载决议选中 - 函数被ODR 式使用 - 函数本该被 ODR 式使用但出现于不求值操作数中
- 该特化需要与另一函数声明进行比较(例如在虚函数覆盖或函数模板的显式特化处) - 在函数定义中 - 需要异常说明,因为某个预置特殊成员函数需要检查它以决定其自身的异常说明(这只会发生于这个预置特殊成员函数自身的异常说明被需要之时)。 | (C++14 起) |
潜在抛出表达式的正式定义(用于确定上述析构函数、构造函数和赋值运算符的缺省异常说明)是:
见动态异常说明。 | (C++17 前) |
以下情况下,表达式 e 为潜在抛出:- e 是对潜在抛出的函数或函数指针的调用- e 对潜在抛出函数进行隐式调用(例如作为重载运算符,new 表达式中的分配函数,函数实参的构造函数,或当 e 为完整表达式时的析构函数)- e 是 throw 表达式- e 是对多态引用类型进行转型的 dynamic_cast- e 是应用于指向多态类型的指针的解引用的 typeid 表达式- e 拥有潜在抛出的直接子表达式
| (C++17 起) |
注解
常量 表达式 的一种用法(与 noexcept
运算符一起)是,定义函数模板,其对一些类型声明 noexcept
,但对其他类型则不声明。
注意,函数上的 noexcept
说明不是一种编译时检查;它只不过是程序员告知编译器函数是否可以抛异常的一种方法。编译器能用此信息启用不抛出函数上的某些优化,以及启用能在编译时检查特定表达式是否声明为可抛出任何异常的 noexcept
运算符。例如,诸如 std::vector 的容器会在元素的移动构造函数为 noexcept
的情况移动元素,否则就复制元素(除非复制构造函数不可访问,但潜在抛出的移动构造函数只在放弃强异常保证的情况考虑)。
弃用
noexcept
是 throw() 的改进版本,后者于 C++11 中弃用。与 C++17 前的 throw() 不同,noexcept
不会调用 std::unexpected,并且可能或可能不进行栈回溯,这潜在地允许编译器实现没有 throw() 的运行时开销的 noexcept
。从 C++17 起,throw() 被重定义为严格等价于 noexcept(true)。
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
CWG 2039 | C++11 | 仅要求转换前的表达式为常量 | 转换必须也在常量表达式中合法 |
关键词
示例
运行此代码
- // foo 是否声明为 noexcept 取决于 T() 是否抛任何异常
- template <class T>
- void foo() noexcept(noexcept(T())) {}
- void bar() noexcept(true) {}
- void baz() noexcept { throw 42; } // noexcept 等同于 noexcept(true)
- int main()
- {
- foo<int>(); // noexcept(noexcept(int())) => noexcept(true),故这是可以的
- bar(); // 可以
- baz(); // 能编译,但在运行时会调用 std::terminate
- }