std::experi...agate_const)(3)

✨ NAME ✨

okay so this page is from the C++ Standard Library manual (the header literally says “C++ Standard Libary” — typo is canon, not me 😭), and it’s all about std::experimental::swap(std::experimental::propagate_const).

The name is std::experimental::swap(std::experimental::propagate_const) — yes, it’s the std::experimental::swap(std::experimental::propagate_const) page, no cap. We’re literally swapping propagate_const besties. 💅

---

🌸 SYNOPSIS 🌸

The man page tags this synopsis as (library fundamentals TS v2), and the signature is:

template< class T >
constexpr void swap( std::experimental::propagate_const<T>& lhs,
                     std::experimental::propagate_const<T>& rhs ) noexcept(/* see below */);

So this specializes the swap algorithm for std::experimental::propagate_const. It swaps the pointers of lhs and rhs. Equivalent to lhs.swap(rhs). 💖

glow-up note: in library fundamentals TS v3, this overload participates in overload resolution only if std::is_swappable_v<T> is true. (Yes, std::is_swappable_v<T> — keep that exact spelling, bestie. 🫶)

---

🎀 PARAMETERS 🎀

• lhs, rhs — the propagate_consts whose contents to swap. That’s the whole assignment. iconic.

---

🦋 RETURN VALUE 🦋

none — literally (none). Nothing comes back. Slay.

---

💀 EXCEPTIONS 💀

The noexcept specification is:

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

So it’s conditionally noexcept, and the vibes are very “depends on lhs.swap(rhs).” 🙈

---

🔥 COMPLEXITY 🔥

Constant. O(1) energy, periodt.

---

🌈 SEE ALSO 🌈

• swap — swaps the values of two objects (function template)
• swap — swaps the wrapped pointer (public member function)

---

👑 CATEGORY 👑

• * conditionally noexcept

---

made with 💖 from cppreference.com, version/date 2024.06.10, and the footer is still giving truncated std::experi...agate_const)(3) main-character energy. bye bestie 🎀✨