std::set_unexpected(3)

🌸 NAME 🌸

std::set_unexpected — std::set_unexpected 💖

okay so this is the page for std::set_unexpected(3) from the C++ Standard Libary manual — yes bestie, that spelling is exactly what the manual name says 😭✨

✨ Synopsis ✨

First up, it's defined in header <exception> 🎀

until C++11:

std::unexpected_handler set_unexpected( std::unexpected_handler f ) throw();

since C++11:

std::unexpected_handler set_unexpected( std::unexpected_handler f ) noexcept;

deprecated and removed in C++17 — not a drill, bestie 💀

It makes f the new global std::unexpected_handler and returns the previously installed std::unexpected_handler 🫶

This function is thread-safe. Every call to std::set_unexpected synchronizes-with (see std::memory_order) the subsequent calls to std::set_unexpected and std::get_unexpected (since C++11) ✨

🎀 Parameters 🎀

• f — pointer to function of type std::unexpected_handler, or null pointer 💅

💖 Return value 💖

The previously-installed unexpected handler, or a null pointer value if none was installed. periodt. 🫶

🦋 See also 🦋

• unexpected (removed in C++17) — function called when dynamic exception specification is violated (function)
• get_unexpected (C++11)(removed in C++17) — obtains the current unexpected_handler (function)
• unexpected_handler (removed in C++17) — the type of the function called by std::unexpected (typedef)

okay bestie, that's the whole page 💖 source: http://cppreference.com, version/date: 2024.06.10, page std::set_unexpected(3) — you ate this one, no cap 👑🌈