Namespaces
Variants
Views
Actions

std::atomic<T>::fetch_xor

From cppreference.com
< cpp‎ | atomic‎ | atomic
 
 
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
(C++11)
Generic lock management
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
Safe Reclamation
(C++26)
Hazard Pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
Memory ordering
Free functions for atomic operations
Free functions for atomic flags
 
 
member only of atomic<Integral > specializations
T fetch_xor( T arg, std::memory_order order =
                        std::memory_order_seq_cst ) noexcept;
(1) (since C++11)
T fetch_xor( T arg, std::memory_order order =
                        std::memory_order_seq_cst ) volatile noexcept;
(2) (since C++11)

Atomically replaces the current value with the result of bitwise XOR of the value and arg. The operation is read-modify-write operation. Memory is affected according to the value of order.

It is deprecated if std::atomic<T>::is_always_lock_free is false and overload (2) participates in overload resolution.

(since C++20)

[edit] Parameters

arg - the other argument of bitwise XOR
order - memory order constraints to enforce

[edit] Return value

The value immediately preceding the effects of this function in the modification order of *this.

[edit] See also

replaces the atomic object with the result of bitwise XOR with a non-atomic argument and obtains the previous value of the atomic
(function template) [edit]