public member function

std::atomic::operator (comp. assign.)

if T is integral (1)	T operator+= (T val) volatile noexcept; T operator+= (T val) noexcept; T operator-= (T val) volatile noexcept; T operator-= (T val) noexcept; T operator&= (T val) volatile noexcept; T operator&= (T val) noexcept; T operator\|= (T val) volatile noexcept; T operator\|= (T val) noexcept; T operator^= (T val) volatile noexcept; T operator^= (T val) noexcept;
if T is pointer (2)	T operator+= (ptrdiff_t val) volatile noexcept; T operator+= (ptrdiff_t val) noexcept; T operator-= (ptrdiff_t val) volatile noexcept; T operator-= (ptrdiff_t val) noexcept;

if T is integral (1)

T operator+= (T val) volatile noexcept;
T operator+= (T val) noexcept;
T operator-= (T val) volatile noexcept;
T operator-= (T val) noexcept;
T operator&= (T val) volatile noexcept;
T operator&= (T val) noexcept;
T operator|= (T val) volatile noexcept;
T operator|= (T val) noexcept;
T operator^= (T val) volatile noexcept;
T operator^= (T val) noexcept;

if T is pointer (2)

T operator+= (ptrdiff_t val) volatile noexcept;
T operator+= (ptrdiff_t val) noexcept;
T operator-= (ptrdiff_t val) volatile noexcept;
T operator-= (ptrdiff_t val) noexcept;

Compound assignments

atomic specializations for integral (1) and pointer (2) types support compound assignments:

Each of these functions accesses the contained value, apply the proper operator and return the value the contained value had immediately before the operation; all in a single atomic operation that cannot be affected by other threads.

These functions behave as if the proper fetch_* member function was called with memory_order_seq_cst as second argument:

operator	member functions		supported for
operator	comp. assign.	equivalent	integral types	pointer types	other types
`+`	`atomic::operator+=`	`atomic::fetch_add`	yes	yes	no
`-`	`atomic::operator-=`	`atomic::fetch_sub`	yes	yes	no
`&`	`atomic::operator&=`	`atomic::fetch_and`	yes	no	no
`\|`	`atomic::operator\|=`	`atomic::fetch_or`	yes	no	no
`^`	`atomic::operator^=`	`atomic::fetch_xor`	yes	no	no

Parameters

val: Value to apply.
T is atomic's template parameter (the type of the contained value).
ptrdiff_t is a signed integral type.

Return value

The value contained after applying the operation.
T is atomic's template parameter (the type of the contained value).

Data races

No data races (atomic operation). The operation uses sequential consistency (memory_order_seq_cst).

Exception safety

No-throw guarantee: never throws exceptions.

std::atomic::operator (comp. assign.)

Parameters

Return value

Data races

Exception safety

See also

C++

Reference

C library:

Containers:

Input/Output:

Multi-threading:

Other:

<atomic>

classes:

enum types:

functions:

initialization macros:

functions (C-style atomics):

atomic

member functions:

member functions (spec.):