Difference between revisions of "cpp/error/unexpected"
(Remove wrong example code) |
Andreas Krug (Talk | contribs) m (fmt, .) |
||
| Line 2: | Line 2: | ||
{{cpp/error/navbar}} | {{cpp/error/navbar}} | ||
{{dcl begin}} | {{dcl begin}} | ||
| − | {{dcl header | exception}} | + | {{dcl header|exception}} |
{{dcl rev begin}} | {{dcl rev begin}} | ||
| − | {{dcl | until=c++11 | | + | {{dcl|until=c++11| |
void unexpected(); | void unexpected(); | ||
}} | }} | ||
| − | {{dcl | since=c++11 | deprecated=yes | until=c++17 | | + | {{dcl|since=c++11|deprecated=yes|until=c++17| |
[[noreturn]] void unexpected(); | [[noreturn]] void unexpected(); | ||
}} | }} | ||
| Line 21: | Line 21: | ||
{{rev begin}} | {{rev begin}} | ||
{{rev|until=c++11| | {{rev|until=c++11| | ||
| − | If a destructor reset the unexpected handler during stack unwinding and the unwinding later led to {{tt|unexpected}} being called, the handler that was installed at the end of the throw expression is the one that will be called | + | If a destructor reset the unexpected handler during stack unwinding and the unwinding later led to {{tt|unexpected}} being called, the handler that was installed at the end of the throw expression is the one that will be called (note: it was ambiguous whether re-throwing applied the new handlers). |
}} | }} | ||
{{rev|since=c++11| | {{rev|since=c++11| | ||
| Line 35: | Line 35: | ||
===Exceptions=== | ===Exceptions=== | ||
| − | Throw any exception thrown by the currently installed {{lc|std::unexpected_handler}} | + | Throw any exception thrown by the currently installed {{lc|std::unexpected_handler}}. |
===Defect reports=== | ===Defect reports=== | ||
{{dr list begin}} | {{dr list begin}} | ||
| − | {{dr list item|wg=lwg|dr=2111|std=C++11|before=effect of calling {{tt|set_unexpected}} during stack unwinding differs from C++98 and breaks some ABIs |after=made unspecified}} | + | {{dr list item|wg=lwg|dr=2111|std=C++11|before=effect of calling {{tt|set_unexpected}} during stack unwinding differs from C++98 and breaks some ABIs|after=made unspecified}} |
{{dr list end}} | {{dr list end}} | ||
===See also=== | ===See also=== | ||
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc | cpp/utility/expected/dsc unexpected}} | + | {{dsc inc|cpp/utility/expected/dsc unexpected}} |
| − | {{dsc inc | cpp/error/dsc unexpected_handler}} | + | {{dsc inc|cpp/error/dsc unexpected_handler}} |
{{dsc end}} | {{dsc end}} | ||
{{langlinks|de|es|fr|it|ja|ru|zh}} | {{langlinks|de|es|fr|it|ja|ru|zh}} | ||
Revision as of 05:28, 16 July 2023
| Defined in header <exception>
|
||
| void unexpected(); |
(until C++11) | |
| [[noreturn]] void unexpected(); |
(since C++11) (deprecated) (removed in C++17) |
|
std::unexpected() is called by the C++ runtime when a dynamic exception specification is violated: an exception is thrown from a function whose exception specification forbids exceptions of this type.
std::unexpected() may also be called directly from the program.
In either case, std::unexpected calls the currently installed std::unexpected_handler. The default std::unexpected_handler calls std::terminate.
|
If a destructor reset the unexpected handler during stack unwinding and the unwinding later led to |
(until C++11) |
|
If a destructor reset the unexpected handler during stack unwinding, it is unspecified which handler is called if the unwinding later led to |
(since C++11) |
Contents |
Parameters
(none)
Return value
(none)
Exceptions
Throw any exception thrown by the currently installed std::unexpected_handler.
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2111 | C++11 | effect of calling set_unexpected during stack unwinding differs from C++98 and breaks some ABIs
|
made unspecified |
See also
| (C++23) |
represented as an unexpected value (class template) |
| (deprecated in C++11)(removed in C++17) |
the type of the function called by std::unexpected (typedef) |
