std::atomic<T>::fetch_and (3) - Linux Manuals

std::atomic<T>::fetch_and: std::atomic<T>::fetch_and


std::atomic<T>::fetch_and - std::atomic<T>::fetch_and


T fetch_and( T arg,
std::memory_order order = std::memory_order_seq_cst ) noexcept; (since C++11)
T fetch_and( T arg, (member only of atomic<Integral> template specialization)
std::memory_order order = std::memory_order_seq_cst ) volatile noexcept;

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


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

Return value

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

See also

atomic_fetch_and_explicit replaces the atomic object with the result of bitwise AND with a non-atomic argument and obtains the previous value of the atomic
                          (function template)