swap(std::expected)(3)

💖 swap(std::expected) 💖

okay so this is the C++ Standard Libary manual page for swap(std::expected) — yes bestie, that’s the manual name, and we’re getting into it 💅

---

✨ NAME ✨

swap(std::expected) — swap(std::expected). That’s the name, that’s the vibe, and honestly? Slay.

---

🦋 Synopsis 🦋

friend constexpr void swap( expected& lhs, expected& rhs )
(since C++23)
noexcept(/*see below*/);

So it overloads the std::swap algorithm for std::expected. It exchanges the state of lhs with that of rhs. Effectively calls lhs.swap(rhs). ✨

This overload participates in overload resolution only if lhs.swap(rhs) is valid. No cap.

This function is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::expected<T, E> is an associated class of the arguments. iykyk 🫶

---

🌸 Parameters 🌸

• lhs, rhs — expected objects whose states to swap. Two besties, one state exchange 💖

---

🎀 Return value 🎀

(none) — literally nothing comes back, bestie. The swap happens in place. 🫶

---

🫶 Exceptions 🫶

the noexcept specification is:

noexcept(noexcept(lhs.swap(rhs)))

and that’s the whole exception situation, periodt.

---

🦋 Example 🦋

This section is incomplete 🫠 Reason: no example

---

🔥 See also 🔥

• swap — exchanges the contents; it’s a public member function. Iconic behavior tbh 💅

---

👑 Categories 👑

• conditionally noexcept
• Todo no example

---

source: http://cppreference.com · version/date: 2024.06.10 · page: swap(std::expected)(3) — mwah 💋