std::nested_exception(3)

🦋 std::nested_exception(3) 🦋

okay bestie, pull up a chair, because today we're talking about a Library Functions Manual page that is lowkey one of the most underrated little gems in libstdc++ — std::nested_exception. she's a mixin, she's nosy, she remembers things. let's get into it. 💅

---

✨ NAME ✨

std::nested_exception — the little mixin class that stores the current exception for you, no cap 💖

---

🌸 SYNOPSIS 🌸

First things first, you gotta let her in the door:

#include <exception>

🎀 Public Member Functions 🎀

• nested_exception () noexcept — the default constructor, and she is thriving. she stores the current exception (if any). if there isn't one? she just vibes.
• nested_exception (const nested_exception &) noexcept=default — the copy constructor, defaulted, noexcept, iconic behavior honestly.
• exception_ptr nested_ptr () const noexcept — your girl lets you access the stored exception. it's giving personal assistant energy.
• nested_exception & operator= (const nested_exception &) noexcept=default — assignment operator, also defaulted, also noexcept. consistent queen. 👑
• void rethrow_nested () const — she rethrows the stored exception, or — and this is the dramatic part — terminates if none was stored. so like. she WILL end the whole program. respect her. 😭

---

💜 Detailed Description 💜

So what is she, fr fr? she's a mixin class that stores the current exception. that's the whole bit. that's her job.

The way you actually use her is through std::throw_with_nested, which lets you store the current exception nested within another exception. it's like those little russian dolls but make it error handling. 🪆✨

Since C++11 🎂 (yes she's been around, she's a classic)

See also std::throw_with_nested — her bestie, her partner in crime 🫶

---

🧚 Constructor & Destructor Documentation 🧚

🌈 std::nested_exception::nested_exception () [inline], [noexcept] 🌈

The default constructor stores the current exception (if any). that's it, that's the whole constructor. she's simple, she's efficient, she's [inline] and [noexcept] and she knows it. ✨

References std::current_exception() — that's where she's pulling the tea from, iykyk. 🍵

---

⭐ Member Function Documentation ⭐

💖 exception_ptr std::nested_exception::nested_ptr () const [inline], [noexcept] 💖

Access the stored exception. that's the whole thing. she's [inline], she's [noexcept], she hands you the exception_ptr and says nothing else. mysterious. elegant. obsessed. 💅

🔥 void std::nested_exception::rethrow_nested () const [inline] 🔥

Rethrow the stored exception, or terminate if none was stored.

⚠️ bestie listen — if there's nothing stored, she calls std::terminate(). that is NOT a drill. your program is done. no recovery, no catching, just vibes and consequences. 💀

she's [inline], she's const, she does not play.

References std::rethrow_exception(), rethrow_nested(), and std::terminate() — yes, she references herself, that's just her main character energy 🌟

Referenced by rethrow_nested() — okay so she's referencing herself AND being referenced by herself. truly her own biggest fan. we love a self-sufficient icon. 🎀

---

🌈 Author 🌈

Generated automatically by Doxygen for libstdc++ from the source code. so nobody wrote this by hand, the robots did it, and honestly? they ate. 🤖✨

---

okay that's the whole page bestie, you're officially fluent in std::nested_exception. this page came to you straight from the libstdc++ girlies, and no date was printed on this one so we're just gonna say whenever this shipped 🕰️ — go forth and nest your exceptions responsibly. mwah. 💖🦋🌸