std::swap(std::promise)(3)

hey bestie, welcome to std::swap(std::promise)(3) 💖 this one lives in the C++ Standard Libary manual, and we’re about to make a very niche swap situation make sense, no cap ✨

🌸 NAME 🌸

std::swap(std::promise) — std::swap(std::promise) 🫶 yes, the name section is doing name-on-name realness, and honestly? iconic 💅

✨ Synopsis ✨

Defined in header <future> 🌸

template< class R >
void swap( promise<R>& lhs, promise<R>& rhs ) noexcept;

This bad boy is since C++11 👑 it specializes the std::swap algorithm for std::promise. It exchanges the shared state of lhs with that of rhs, and effectively calls lhs.swap(rhs) ✨

🎀 Parameters 🎀

• lhs, rhs — promises whose states to swap 🦋

🦋 Return value 🦋

(none) — literally nothing comes back, bestie, it just does the swap and vibes 😌

🌈 Example 🌈

This section is incomplete Reason: no example

not me leaving the example slot empty 😭 but fr fr, that’s what the page says 🫶

👀 See also 👀

• swap — swaps two promise objects (public member function) 💫

📌 Category 📌

• * Todo no example 📝

xoxo, your source/version is http://cppreference.com, dated 2024.06.10, and this manual page is std::swap(std::promise)(3) 💅✨