std::uncaught_exception,std::uncaught_exceptions (3) - Linux Manuals

std::uncaught_exception,std::uncaught_exceptions: std::uncaught_exception,std::uncaught_exceptions


std::uncaught_exception,std::uncaught_exceptions - std::uncaught_exception,std::uncaught_exceptions


Defined in header <exception>
bool uncaught_exception() throw(); (until C++11)
                                            (since C++11)
bool uncaught_exception() noexcept; (1) (deprecated in C++17)
                                            (removed in C++20)
int uncaught_exceptions() noexcept; (2) (since C++17)

1) Detects if the current thread has a live exception object, that is, an exception has been thrown or rethrown and not yet entered a matching catch clause, std::terminate or std::unexpected. In other words, std::uncaught_exception detects if stack_unwinding is currently in progress.
2) Detects how many exceptions in the current thread have been thrown or rethrown and not yet entered their matching catch clauses.
Sometimes it's safe to throw an exception even while std::uncaught_exception() == true. For example, if stack_unwinding causes an object to be destructed, the destructor for that object could run code that throws an exception as long as the exception is caught by some catch block before escaping the destructor.



Return value

1) true if stack unwinding is currently in progress in this thread.
2) The number of uncaught exception objects in the current thread.


An example where int-returning uncaught_exceptions is used is the boost.log library: the expression BOOST_LOG(logger) << foo(); first creates a guard object and records the number of uncaught exceptions in its constructor. The output is performed by the guard object's destructor unless foo() throws (in which case the number of uncaught exceptions in the destructor is greater than what the constructor observed)


// Run this code

  #include <iostream>
  #include <exception>
  #include <stdexcept>

  struct Foo {
      int count = std::uncaught_exceptions();
      ~Foo() {
          std::cout << (count == std::uncaught_exceptions()
              ? "~Foo() called normally\n"
              : "~Foo() called during stack unwinding\n");
  int main()
      Foo f;
      try {
          Foo f;
          std::cout << "Exception thrown\n";
          throw std::runtime_error("test exception");
      } catch (const std::exception& e) {
          std::cout << "Exception caught: " << e.what() << '\n';


  Exception thrown
  ~Foo() called during stack unwinding
  Exception caught: test exception
  ~Foo() called normally

External links

* GOTW_issue_47:_Uncaught_Exceptions
* Rationale_for_std::uncaught_exceptions

See also

                  function called when exception handling fails
terminate (function)

exception_ptr shared pointer type for handling exception objects

current_exception captures the current exception in a std::exception_ptr