exception -----> Functions

/* current_exception */

exception_ptr current_exception() noexcept;

返回指向当前异常（或其副本）的智能指针【具体返回对象本身还是副本，是由具体实现库决定的】，如果当前没有异常发生，那么返回一个null-pointer。exception_ptr是一种shared smart pointer类型：只要仍然有一个exception_ptr指向它，那么被指向的exception对象必须保持有效状态，因此，可以利用exception_ptr跨线程间处理异常。

current_exception函数不抛出异常，但是如果实现该函数时，返回的是指向当前副本的指针，那么如果分配内存失败或者复制副本过程失败，将返回一个bad_exception或者一些未定义的值。

/* get_terminate */

terminate_handler get_terminate() noexcept;

返回终止处理函数。当没有catch语句块可以匹配时，自动调用该函数终止程序的执行。如果之前系统中没有通过set_terminate函数设置终止处理函数，那么根据不同实现系统可能返回一个abort()或者null-pointer。

/* get_unexpected */

unexpected_handler get_unexpected() noexcept;

当函数抛出throw列表中未声明的异常类型时，系统自动调用unexpected处理函数。如果未指定，那么该函数将返回一个unspecified value。

/* make_exception_ptr */

template <class E>

exception_ptr make_exception_ptr(E e) noexcept;

返回一个指向e的副本的exception_ptr对象。其行为等价于如下：

template <class E> exception_ptr make_exception_ptr (E e) noexcept {

try {

throw e;

} catch(...) {

return current_exception();

}

}

 // make_exception_ptr example
 #include <iostream>       // std::cout
 #include <exception>      // std::make_exception_ptr, std::rethrow_exception
 #include <stdexcept>      // std::logic_error

 int main()
 {
     auto p = std::make_exception_ptr(std::logic_error("logic_error"));

     try
     {
         std::rethrow_exception (p);
     }
     catch(const std::exception& e)
     {
         std::cout << "exception caught: " << e.what() << '\n';
     }

     return ;
 }

/* rethrow_exception */

[[noreturn]] void rethrow_exception(exception_ptr p);

抛出p所指的异常对象。此时参数p不能为null exception_ptr，否则将引起未定义的行为。

/* set_terminate */

terminate_handler set_terminate(terminate_handler f) noexcept;

将f设置为终止处理函数。如果没有调用该函数设置f，那么系统在适当时候会调用abort()。程序中可以通过调用terminate()来显式调用当前的终止处理函数，即显式调用f或者abort()。

该函数不抛出异常，如果f是无效的或者没有被正确的实现，那么将引起未定义的行为。

 // set_terminate example
 #include <iostream>       // std::cerr
 #include <exception>      // std::set_terminate
 #include <cstdlib>        // std::abort

 void myterminate()
 {
   std::cerr << "terminate handler called\n";
   abort();  // forces abnormal termination
 }

 int main()
 {
   std::set_terminate(myterminate);
   throw ;  // unhandled exception: calls terminate handler

   return ;
 }

/* set_unexpected */

unexpected_handler set_unexpected(unexpected_handler f) noexcept;

/* terminate */

[[noreturn]]void terminate() noexcept;

调用当前终止处理函数。默认情况下调用abort()，但是也可以通过set_terminate()函数来指定。

 // terminate example
 #include <iostream>       // std::cout, std::cerr
 #include <exception>      // std::exception, std::terminate

 int main()
 {
     char* p, *p2;
     std::cout << "Attempting to allocate 2 GB at the same point ...";
     try
     {
         p = new char[1024*1024*1024];
12         p2 = new char[1024*1024*1024];
     }
     catch (std::exception& e)
     {
         std::cerr << "ERROR: could not allocate storage\n";
         std::terminate();
     }
     std::cout << "Ok\n";

     delete[] p2;
     delete[] p;
     return ;
 }

/* uncaught_exception */

bool uncaught_exception() noexcept;

如果已经抛出了异常，但是还没有被合适的catch语句块处理，则返回true，否则返回false。

/* unexpected */

[[noreturn]] void unexpected();

调用当前unexpected处理函数。默认情况下调用terminate()。但是可以通过set_unexpected()来指定。

/* throw_with_nested */

[[noreturn]] template <class T>

void throw_with_nested(T&& e);

抛出一个联合了当前异常及指定e的嵌套异常。当前异常变为nested exception，而指定e变为outer exception。