std::atomic...:notify_one(3)

✨ NAME ✨

Okay so bestie, we're in the C++ Standard Libary manual (yes, that's the manual name in the header — I don't make the rules 😭), and this page is all about:

std::atomic_flag::notify_one — std::atomic_flag::notify_one

Yes, the name is giving "said it twice to make it stick" 💅. Iconic.

---

🌸 Synopsis 🌸

Here are the signatures, literally exact, no cap:

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

Both of these are since C++20 — vintage-ish but still fresh 💖.

Performs atomic notifying operations.

If there is a thread blocked in atomic waiting operation (i.e. wait()) on *this, then unblocks at least one such thread; otherwise does nothing.

---

🫶 Return value 🫶

(none)

Literally none, bestie. No return value, no extra drama. 💀

---

🔥 Notes 🔥

This form of change-detection is often more efficient than simple polling or pure spinlocks.

Ngl, that's kind of a slay for performance. 💅

---

😭 Example 😭

This section is incomplete.

Reason: no example

Not me opening the example section and finding out it's empty 🫠. It's giving "left on read."

---

👑 See also 👑

• wait — blocks the thread until notified and the atomic value changes. (C++20) (public member function)
• atomic_flag_wait — blocks the thread until notified and the flag changes. (C++20) (function)
• atomic_flag_wait_explicit — blocks the thread until notified and the flag changes. (C++20) (function)
• atomic_flag_notify_one — notifies a thread blocked in atomic_flag_wait. (C++20) (function)

---

🏷️ Category 🏷️

• * Todo no example

---

Source/version/date tea ☕: http://cppreference.com · 2024.06.10 · page std::atomic...:notify_one(3)

Bye bestie — go unblock at least one thread and slay 💖🦋✨