| Defined in header <future> | ||||
|---|---|---|---|---|
| (since C++11) |
The class std::future_error defines an exception object that is thrown on failure by the functions in the thread library that deal with asynchronous execution and shared states (std::future, std::promise, etc). Similar to std::system_error, this exception carries an error code compatible with std::error_code.
Inheritance diagram.
Member functions
creates a std::future_error object (public member function) | |
| returns the error code (public member function) | |
| returns the explanatory string specific to the error code (public member function) |
Inherited from std::logic_error
Inherited from std::exception
Member functions
| (destructor)
[virtual] | destructs the exception object (virtual public member function of std::exception) |
| [virtual] | returns an explanatory string (virtual public member function of std::exception) |
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | #include <future>#include <iostream> int main(){ std::future<int> empty; try { int n = empty.get(); // The behavior is undefined, but // some implementations throw std::future_error } catch (const std::future_error& e) { std::cout << "Caught a future_error with code \"" << e.code() << "\"\nMessage: \"" << e.what() << "\"\n"; }} |
Possible output:
1 2 | Caught a future_error with code "future:3"Message: "No associated state" |
See also
| (C++11) | identifies the future error codes (enum) |
Please login to continue.