# std::get_unexpected

> C++ Atlas: `cppatlas.com/w/cpp/error/get_unexpected` | Source: https://en.cppreference.com/w/cpp/error/get_unexpected | Domain: Diagnostics | Standards: C++11, C++17

Returns the currently installed std::unexpected_handler, which may be a null pointer.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <exception>
std::unexpected_handler get_unexpected() noexcept; // (deprecated in C++11) (removed in C++17)
```

Returns the currently installed `std::unexpected_handler`, which may be a null pointer.

This function is thread-safe. Prior call to `std::set_unexpected` *synchronizes-with* (see `std::memory_order`) the subsequent calls to this function. (since C++11)

### Parameters

(none)

### Return value

The currently installed `std::unexpected_handler`.

### See also

- [`unexpected_handler`](https://en.cppreference.com/w/cpp/error/unexpected_handler) (deprecated in C++11): the type of the function called by `std::unexpected` (typedef)
- [`set_unexpected`](https://en.cppreference.com/w/cpp/error/set_unexpected) (deprecated in C++11): changes the function to be called by `std::unexpected` (function)

---
Attribution: content from https://en.cppreference.com/w/cpp/error/get_unexpected (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.