函数
<exception>

std::throw_with_nested

[[noreturn]] template <class T>  void throw_with_nested (T&& e);
嵌套抛出
抛出一个异常,该异常结合了当前处理的异常e

当前处理的异常成为嵌套异常,而 e 成为外部异常

抛出的异常类型将公开派生自 T当前处理的异常(后者作为 nested_exception 成分)。

如果 T 是引用类型,则它继承的类型是没有引用的类型,该类型是 T 引用的,并且必须是可复制构造的。

如果当前没有通过 catch 块处理异常,则嵌套异常是一个exception_ptr

参数

e
一个非联合类对象或引用,它不派生自 nested_exception

返回值

无(该函数永不返回)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// throw_with_nested/rethrow_if_nested example
#include <iostream>       // std::cerr
#include <exception>      // std::exception, std::throw_with_nested, std::rethrow_if_nested
#include <stdexcept>      // std::logic_error

// recursively print exception whats:
void print_what (const std::exception& e) {
  std::cerr << e.what() << '\n';
  try {
    std::rethrow_if_nested(e);
  } catch (const std::exception& nested) {
    std::cerr << "nested: ";
    print_what(nested);
  }
}

// throws an exception nested in another:
void throw_nested() {
  try {
    throw std::logic_error ("first");
  } catch (const std::exception& e) {
    std::throw_with_nested(std::logic_error("second"));
  }
}

int main () {
  try {
    throw_nested();
  } catch (std::exception& e) {
    print_what(e);
  }

  return 0;
}

输出

second
nested: first


异常安全

抛出异常。

如果参数不是正确的类型(如上所述),则该调用会导致未定义行为

另见