Namespaces
Variants
Views
Actions

std::atomic_ref<T>::operator++,++(int),--,--(int)

From cppreference.com
< cpp‎ | atomic‎ | atomic ref
 
 
Concurrency support library
Threads
(C++11)
(C++20)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
Mutual exclusion
(C++11)
(C++11)  
Generic lock management
(C++11)
(C++11)
(C++11)
(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)
(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 of atomic_ref<Integral> specializations
and atomic_ref<T*> partial specialization
value_type operator++() const noexcept;
(1) (since C++20)
value_type operator++( int ) const noexcept;
(2) (since C++20)
value_type operator--() const noexcept;
(3) (since C++20)
value_type operator--( int ) const noexcept;
(4) (since C++20)

Atomically increments or decrements the current value of the referenced object. These operations are read-modify-write operations.

1) Performs atomic pre-increment. Equivalent to return fetch_add(1) + 1;.
2) Performs atomic post-increment. Equivalent to return fetch_add(1);.
3) Performs atomic pre-decrement. Equivalent to return fetch_sub(1) - 1;
4) Performs atomic post-decrement. Equivalent to return fetch_sub(1);.

For signed Integral types, arithmetic is defined to use two’s complement representation. There are no undefined results.

For T* types, the result may be an undefined address, but the operations otherwise have no undefined behavior. The program is ill-formed if T is not an object type.

[edit] Return value

1,3) The value of the referenced object after the modification.
2,4) The value of the referenced object before the modification.

[edit] Notes

Unlike most pre-increment and pre-decrement operators, the pre-increment and pre-decrement operators for atomic_ref do not return a reference to the modified object. They return a copy of the stored value instead.

[edit] See also

atomically adds the argument to the value stored in the referenced object and obtains the value held previously
(public member function) [edit]
atomically subtracts the argument from the value stored in the referenced object and obtains the value held previously
(public member function) [edit]
atomically adds to or subtracts from the referenced value
(public member function) [edit]
atomically performs bitwise AND, OR, XOR with the referenced value
(public member function) [edit]