std::atomic_ref<T>::fetch_sub

value_type fetch_sub( difference_type arg,
                      std::memory_order order =
                          std::memory_order_seq_cst ) const noexcept;

Атомарно заменяет текущее значение объекта, на который ведёт ссылка, результатом арифметического вычитания значения arg. Эта операция является операцией чтения-модификации-записи. Порядок работы с памятью определяется значением order.

• Для знаковых целочисленных типов арифметика определяется с использованием дополнительного кода. Неопределённых результатов нет.
• Для типов с плавающей точкой действующая среда обработки чисел с плавающей точкой может отличаться от среды обработки чисел с плавающей точкой вызывающего потока. Операция не обязана соответствовать соответствующим признакам std::numeric_limits, но рекомендуется это делать. Если результат не представим для своего типа, он не определён, но в остальном операция не имеет неопределённого поведения.
• Для типов указателей результат может быть неопределённым адресом, но в остальном операция не имеет неопределённого поведения.
  • Если std::remove_pointer_t<T> не является полным типом объекта, программа некорректна.

Эта перегрузка участвует в разрешении перегрузки только в том случае, если std::is_const_v<T> равно false.

Параметры

Возвращаемое значение

Значение, на которое ссылается *ptr, непосредственно перед выполнением этой функции.

Пример

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющих поведение, были применены ретроактивно к ранее опубликованным стандартам C++.