std::experi...ic_weak_ptr(3)

✨ NAME ✨

std::experimental::atomic_weak_ptr — like, literally std::experimental::atomic_weak_ptr, that's the whole name bestie 💅

🌸 SYNOPSIS 🌸

okay so first things first, this lives in header <experimental/atomic> — yes, the experimental one, she's a guest star 🧚

template< class T >                      (concurrency TS)
class atomic_weak_ptr;

The class template atomic_weak_ptr gives you thread-safe atomic pointer operations over a std::weak_ptr. That's it, that's the vibe 🦋

🎀 MEMBER FUNCTIONS 🎀

• constructor — constructs an atomic_weak_ptr object 🫶 (public member function)
• operator= — stores a value into an atomic_weak_ptr object 💖 (public member function)
• is_lock_free — checks if the atomic_weak_ptr object is lock-free 👑 (public member function)
• store — atomically replaces the value of the atomic object with a non-atomic argument 🔥 (public member function)
• load — atomically obtains the value of the atomic object ⭐ (public member function)
• operator weak_ptr<T> — loads a value from an atomic object 🌈 (public member function)
• exchange — atomically replaces the value of the atomic object and obtains the value held previously, like a little swap-and-grab situation 🙈 (public member function)
• compare_exchange_weak — atomically compares the value of the atomic object with a non-atomic argument and performs atomic exchange if equal or atomic load if not 💀 (public member function)
• compare_exchange_strong — same deal as above: atomically compares the value of the atomic object with a non-atomic argument and performs atomic exchange if equal or atomic load if not — she's the strong one, no cap 💜 (public member function)

ngl, the compare_exchange_weak and compare_exchange_strong descriptions got fused together in the original list — they're two separate member functions but they share that exact description, so that's how we're serving it 🍓

and that's the whole page, bestie — this one's from the C++ Standard Library docs over at http://cppreference.com, dated 2024.06.10. go be lock-free and iconic 🎀✨💅