std::atomic::store(3)

💾 std::atomic::store(3) 💾

okay so welcome to the C++ Standard Libary manual, bestie — this page is std::atomic::store(3) and she is here to atomically replace stuff 💅✨

---

🎀 NAME 🎀

std::atomic::store - std::atomic::store

(no cap, that's the whole name section, she's concise like that 🫶)

---

✨ Synopsis ✨

void store( T desired, std::memory_order order =
            std::memory_order_seq_cst ) noexcept;

Overload (1), since C++11 🌸

void store( T desired, std::memory_order order =
            std::memory_order_seq_cst ) volatile
noexcept;

Overload (2), since C++11 🌸

Atomically replaces the current value with desired. Memory is affected according to the value of order.

🚨 if order is one of std::memory_order_consume, std::memory_order_acquire and std::memory_order_acq_rel, the behavior is undefined. That's not a vibe, bestie — do not do it 😭

😭 Since C++20, it is deprecated if std::atomic<T>::is_always_lock_free is false and overload (2) participates in overload resolution. That's the caveat, fr fr.

---

🌸 Parameters 🌸

• desired — the value to store into the atomic variable 💖
• order — memory order constraints to enforce 👑

---

🦋 Return value 🦋

(none) — literally no return value, she's not giving anything back and that's the point 💅

---

👑 See also 👑

• operator= — stores a value into an atomic object (public member function)
• atomic_store — atomically replaces the value of the atomic object with a non-atomic argument (C++11) (function template)
• atomic_store_explicit — atomically replaces the value of the atomic object with a non-atomic argument (C++11) (function template)

---

source: http://cppreference.com · version/date: 2024.06.10 · page: std::atomic::store(3) — mwah, bye bestie 🫶💖