std::atomic_ref::fetch_xor(3)

🎀 NAME 🎀 — std::atomic_ref::fetch_xor(3)

okay so this is the std::atomic_ref::fetch_xor page from the C++ Standard Libary manual 💅 (yes bestie, that's the manual name up top). The function itself is std::atomic_ref::fetch_xor — std::atomic_ref::fetch_xor, periodt.

🔥 Synopsis 🔥

it's a member only of atomic_ref<Integral> specializations, and the signature is giving exactly this:

member only of atomic_ref<Integral> specializations

T fetch_xor( T arg,
             std::memory_order order = std::memory_order_seq_cst )
(since C++20)
const noexcept;

so what does it do? Atomically replaces the current value of the referenced object with the result of bitwise XOR of the value and arg. This operation is a read-modify-write operation. Memory is affected according to the value of order ✨.

🎀 Parameters 🎀

• arg — the other argument of bitwise XOR. that's the second little XOR bestie in the mix 💅
• order — memory order constraints to enforce. it's the memory-ordering vibe check 🫶

💖 Return value 💖

The value of the referenced object, immediately preceding the effects of this function. so you get the value from right before this function did its thing, no cap 😭👑

source: http://cppreference.com · date: 2024.06.10 · page: std::atomic_ref::fetch_xor(3) — mwah, bestie 💋💅