std::atomic::fetch_sub

T fetch_sub( T arg, 
             std::memory_order order = std::memory_order_seq_cst );

T fetch_sub( T arg, 
             std::memory_order order = std::memory_order_seq_cst ) volatile;

T* fetch_sub( std::ptrdiff_t arg, 
              std::memory_order order = std::memory_order_seq_cst );

T* fetch_sub( std::ptrdiff_t arg, 
              std::memory_order order = std::memory_order_seq_cst ) volatile;

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

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.

Parameters

Return value

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

Exceptions

See also