std::get_new_handler(3)

💖 std::get_new_handler(3) 💖

okay so this page is from the C++ Standard Libary manual, and it's all about std::get_new_handler — yes bestie, the function whose whole job is telling you which new-handler is currently installed. 🫶

🌸 NAME 🌸

std::get_new_handler — std::get_new_handler. That's the name, and honestly? iconic. ✨

✨ Synopsis ✨

Defined in header <new>:

std::new_handler get_new_handler() noexcept;  (since C++11)

Returns the currently installed new-handler, which may be a null pointer. 👀

This function is thread-safe. A previous call to std::set_new_handler synchronizes-with (see std::memory_order) the subsequent calls to std::get_new_handler. No cap, that's the documented sync situation. 🔥

🎀 Parameters 🎀

(none). Not a single argument, bestie — zero args, zero drama. 🫶

🌈 Return value 🌈

The currently installed new-handler, which may be a null pointer value. So yeah, it can be null — that's the whole return-value tea. 💅

🦋 See also 🦋

• operator new — allocation functions
• operator new[] — (function)
• set_new_handler — registers a new handler (function)
• new_handler — function pointer type of the new handler (typedef)

okay that's the page, bestie. Source/version/date sign-off: it's from http://cppreference.com, dated 2024.06.10, and it's the std::get_new_handler(3) page. Bye, slay, hydrate, and may your handler never be null unless it's supposed to be 💖✨💅