Scroll to navigation

std::atomic::fetch_and(3) C++ Standard Libary std::atomic::fetch_and(3)

NAME

std::atomic::fetch_and - std::atomic::fetch_and

Synopsis


member only of atomic<Integral > specializations
T fetch_and( T arg, std::memory_order order = (1) (since C++11)
std::memory_order_seq_cst ) noexcept;
T fetch_and( T arg, std::memory_order order =
std::memory_order_seq_cst ) volatile (2) (since C++11)
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.


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

Parameters


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 replaces the atomic object with the result of bitwise AND
atomic_fetch_and_explicit with a non-atomic argument and obtains the previous value
(C++11) of the atomic
(C++11) (function template)

2024.06.10 http://cppreference.com