std::experi...ope_success(3)

okay so bestie, welcome to the std::experi...ope_success(3) page from the C++ Standard Libary man page — yes, that's the manual name, typo and all 💅 this is the std::experimental::scope_success destructor and she is very specific about when she fires.

✨ NAME ✨

std::experimental::scope_success::~scope_success — std::experimental::scope_success::~scope_success 🎀

🦋 Synopsis 🦋

The destructor signature is literally this, bestie:

~scope_success() noexcept(noexcept(std::declval<EF&>()()));

It's tagged (library fundamentals TS v3) 🌸

Here's the vibe: it calls the exit function if the result of std::uncaught_exceptions() is less than or equal to the counter of uncaught exceptions (typically on normal exit) and the scope_success is active. Then it destroys the stored EF (if it is a function object) and any other non-static data members. periodt. 💅

💖 Exceptions 💖

Throws any exception thrown by calling the exit function. no cap 😭

🎀 Notes 🎀

Whether the destructor is called on stack unwinding can be detected by the comparison of the result of std::uncaught_exceptions() and the counter of uncaught exceptions in the scope_success. 🦋

Unlike other classes or class template specializations in the C++ standard library and other C++ TR/TS's, scope_success's destructor is permitted to throw an exception. Yes, really — she's built different 👑✨

🌈 See also 🌈

• release makes the scope_success inactive (public member function) — iconic little switch-up 💖

This adorable little page came from http://cppreference.com, dated 2024.06.10 — that's the source and date from the footer, bestie, and yes the whole thing is giving C++ Standard Libary energy 🫶💅🌸