std::nested...throw_nested(3)

💖 NAME 💖

okay so bestie, welcome to the std::nested_exception::rethrow_nested page from the C++ Standard Libary 💅. The name line is literally std::nested_exception::rethrow_nested — std::nested_exception::rethrow_nested (yes, it said it twice, and honestly? iconic 💀). This function is the one that rethrows the stored exception, and if there’s no stored exception it’s giving std::terminate energy 😭.

✨ Synopsis ✨

[[noreturn]] void rethrow_nested() const;  (since C++11)

so what does it actually do? It rethrows the stored exception 💥. If there is no stored exceptions (i.e. nested_ptr() returns a null pointer), then std::terminate is called. and that’s the whole plot, bestie 😭.

This slayful signature has been around since C++11 🌈. The [[noreturn]] is literally right there in the signature, so don’t expect it to come back and say hi 🫶.

⚠️ real talk: it rethrows the stored exception. But if there is no stored exceptions (i.e. nested_ptr() returns a null pointer), then std::terminate is called. not a vibe check you want to fail 💀.

🎀 Parameters 🎀

(none) — zero, nada, no arguments, bestie 🎀.

🦋 Return value 🦋

(none) — none at all, because [[noreturn]] said what it said 💅.

source/version check bestie: http://cppreference.com, date 2024.06.10, page std::nested...throw_nested(3) — slay, bye 💖✨