std::atomic::notify_all(3)

💖 std::atomic::notify_all(3) 💖

okay so bestie, this page is from the C++ Standard Libary manual (yes, that spelling is exactly what the original says, not me 💀). it’s giving concurrency, it’s giving C++20, and it’s literally called std::atomic::notify_all.

🎀 NAME 🎀

std::atomic::notify_all - std::atomic::notify_all — yes, the name and the one-liner are the same thing twice, and honestly? iconic. 💅

✨ Synopsis ✨

void notify_all() noexcept;          (1) (since C++20)
void notify_all() volatile noexcept; (2) (since C++20)

so what does it do? it performs atomic notifying operations. that’s the main character move. 👑

it unblocks all threads blocked in atomic waiting operations (i.e. wait()) on *this, if there are any; otherwise it does nothing. that’s it. no cap. 🫶

💖 Return value 💖

(none) — literally none. nothing. zero. the void is voiding. 😭

📝 Notes 📝

this form of change-detection is often more efficient than simple polling or pure spinlocks. periodt. that’s the note, bestie — it’s giving efficient, it’s giving not-spinning-forever. ✨

🌸 Example 🌸

This section is incomplete. Reason: no example. 😭 so there’s literally no example here — it’s in the todo pile, bestie.

👀 See also 👀

• wait — blocks the thread until notified and the atomic value changes (C++20) (public member function)
• atomic_wait — (C++20)
• atomic_wait_explicit — blocks the thread until notified and the atomic value changes (C++20) (function template)
• atomic_notify_one — notifies a thread blocked in atomic_wait (C++20) (function template)

🏷️ Category 🏷️

• * Todo no example

signed off from http://cppreference.com on 2024.06.10, page std::atomic::notify_all(3) 💅✨