std::atomic_ref<T>:: operator++,++ (int) ,--,-- (int)
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
|
(C++26)
|
||||
|
Operations for arithmetic types
(except
bool
and pointer-to-object)
|
||||
|
Operations for integral types
(except
bool
and pointer-to-object)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
atomic_ref::operator++
atomic_ref::operator++(int)
atomic_ref::operator--
atomic_ref::operator--(int)
|
||||
|
Operations for integral types
(except
bool
)
|
||||
| Constants | ||||
|
Provided only when
T
is an integral type other than
cv
bool
or a pointer-to-object type
|
||
|
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.
- For signed integral types, arithmetic is defined to use two’s complement representation. There are no undefined results.
- For pointer-to-object types, the result may be an undefined address, but the operations otherwise have no undefined behavior. The program is ill-formed if std:: remove_pointer_t < T > is not a complete object type.
These overloads participate in overload resolution only if std:: is_const_v < T > is false .
Contents |
Return value
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.
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
|
LWG 3508
( P3323R1 ) |
C++20 | increment and decrement operators were meaningless for const T |
constrained to accept only non-const
T
|
See also
|
atomically adds the argument to the value stored in the referenced object and obtains the value held previously
(public member function) |
|
|
atomically subtracts the argument from the value stored in the referenced object and obtains the value held previously
(public member function) |
|
|
atomically adds to or subtracts from the referenced value
(public member function) |
|
|
atomically performs bitwise AND, OR, XOR with the referenced value
(public member function) |