std::atomic...ar_explicit(3)

std::atomic_flag_clear,std::atomic_flag_clear_explicit 💅

okay so this is the std::atomic...ar_explicit(3) page from the C++ Standard Libary manual, section 3 — yes, that’s the exact spelling in the header, no cap. Welcome to the group chat, bestie. ✨

✨ NAME ✨

std::atomic_flag_clear,std::atomic_flag_clear_explicit - std::atomic_flag_clear,std::atomic_flag_clear_explicit

🌸 Synopsis 🌸

here’s the exact code, periodt:

          Defined in header <atomic>
          void atomic_flag_clear( volatile std::atomic_flag* obj ) noexcept;
       (1) (since C++11)
          void atomic_flag_clear( std::atomic_flag* obj ) noexcept;
       (2) (since C++11)
          void atomic_flag_clear_explicit( volatile std::atomic_flag* obj,
                                           std::memory_order order )
       (3) (since C++11)
          noexcept;
          void atomic_flag_clear_explicit( std::atomic_flag* obj,
                                           std::memory_order order )
       (4) (since C++11)
          noexcept;

🎀 Parameters 🎀

• obj — pointer to std::atomic_flag to access 🫶
• order — the memory synchronization ordering 🎀

💅 Notes 💅

std::atomic_flag_clear and std::atomic_flag_clear_explicit can be implemented as obj->clear() and obj->clear(order) respectively. slay. 💅

🌸 Defect reports 🌸

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

• DR: LWG 2138 · Applied to: C++11 · Behavior as published: order could be std::memory_order_consume · Correct behavior: the behavior is undefined in this case.

🌈 See also 🌈

• atomic_flag — the lock-free boolean atomic type (C++11) (class) 👑
• atomic_flag_test_and_set — atomically sets the flag to true and returns its previous value (C++11) (function) 🔥
• atomic_flag_test_and_set_explicit — atomically sets the flag to true and returns its previous value (C++11) (function) 🔥
• memory_order — defines memory ordering constraints for the given atomic operation (C++11) (enum) 🌈
• C documentation for atomic_flag_clear, atomic_flag_clear_explicit 📚

💖 source: http://cppreference.com · version/date: 2024.06.10 · page: std::atomic...ar_explicit(3) — bye bestie, go clear those flags responsibly! 🫶