std::atomic_ref::store(3)

💖 NAME 💖

std::atomic_ref::store(3) — the page from the C++ Standard Libary manual where std::atomic_ref::store lives. Bestie, it's the member that stores a value atomically into the referenced object. Periodt. ✨

📝 Synopsis 📝

Here's the exact signature, no edits, iykyk:

          void store( T desired, std::memory_order order =
       (since C++20)
          std::memory_order_seq_cst ) const noexcept;

This one is noexcept, and the (since C++20) note is right there in the signature. It atomically replaces the current value of the referenced object with desired. Memory is affected according to the value of order. 💅

🚨 Warning bestie: order must be one of std::memory_order_relaxed, std::memory_order_release or std::memory_order_seq_cst. Otherwise the behavior is undefined. Not me being dramatic — it's literally in the page. 💀

🎀 Parameters 🎀

• desired — the value to store into the referenced object. 🍓
• order — memory order constraints to enforce. 🧚

🌈 Return value 🌈

• (none) — literally nothing comes back. Iconic. ✨

👀 See also 👀

• operator= — stores a value into the object referenced by an atomic_ref object (public member function). 💖

Cute sign-off: this page is from http://cppreference.com, dated 2024.06.10, and it's the std::atomic_ref::store(3) page. Bye bestie, go store something atomically. 💜🦋