std::exception(3)

💖 std::exception — NAME 💖

std::exception — the base class for all library exceptions. Like, the OG. The mother of every throw you've ever panic-written at 3am. This page lives in the Library Functions Manual section (3), iykyk 🫶

---

✨ SYNOPSIS ✨

#include <exception>

🌸 Inherited by

Bestie, the docs literally list these as inherited-by, and four of the entries came through completely blank in the source — so here's exactly what's there, gaps and all:

• (blank)
• (blank)
• (blank)
• (blank)
• __gnu_cxx::forced_error
• __gnu_cxx::recursive_init_error
• std::bad_alloc
• std::bad_cast
• std::bad_exception
• std::bad_function_call

🎀 Public Member Functions

• _GLIBCXX26_CONSTEXPR exception(const exception &)=default — copy constructor, defaulted, no notes 💅
• _GLIBCXX26_CONSTEXPR exception(exception &&)=default — move constructor, also defaulted, also iconic
• _GLIBCXX26_CONSTEXPR exception & operator=(const exception &)=default — copy assignment, defaulted
• _GLIBCXX26_CONSTEXPR exception & operator=(exception &&)=default — move assignment, defaulted
• virtual constexpr const char * what() const noexcept — the one member function that actually does something 🦋

---

👑 Detailed Description 👑

Base class for all library exceptions.

Okay so real talk: this is the base class for all exceptions thrown by the standard library, and by certain language expressions. That's a lot of responsibility for one little class. Main character energy, honestly.

And here's the freeing part — you are free to:

• derive your own exception classes 🎀
• use a different hierarchy entirely (go off, build your own kingdom) 🏰
• throw non-class data (like, e.g., fundamental types) 😭

No cap, the standard library is not the boss of you.

---

🔥 Member Function Documentation 🔥

⭐ virtual constexpr const char * std::exception::what() const [inline], [constexpr], [virtual], [noexcept]

Returns a C-style character string describing the general cause of the current error. That's it, that's the job. It's giving "explain yourself in C-string form" 💀

Reimplemented in:

• std::bad_alloc
• std::bad_cast
• std::bad_exception
• std::bad_function_call
• std::bad_typeid
• std::bad_weak_ptr
• std::experimental::filesystem::v1::filesystem_error
• std::experimental::fundamentals_v1::bad_any_cast
• std::filesystem::filesystem_error
• std::future_error
• std::ios_base::failure
• std::logic_error
• std::runtime_error

Lowkey every single one of them said "not me inheriting what() and doing nothing with it" and then went and overrode it anyway. Respect. 🫶

---

🌈 Author 🌈

Generated automatically by Doxygen for libstdc++ from the source code. Not a human, just a very diligent robot ✨

---

And that's the whole page, bestie — footer said libstdc++ (that's the source/version, courtesy of the libstdc++ manual itself, with the standard std::exception(3) running header up top). No date on this one, so don't come for me. Study it, love it, override what() responsibly. Periodt. 💅🎀💖