std::atomic::fetch_add

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека атомарных операций

Типы

atomic (C++11)

atomic_ref (C++20)

Функции

atomic_storeatomic_store_explicit (C++11)(C++11)

atomic_loadatomic_load_explicit (C++11)(C++11)

atomic_exchangeatomic_exchange_explicit (C++11)(C++11)

atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit (C++11)(C++11)(C++11)(C++11)

atomic_fetch_addatomic_fetch_add_explicit (C++11)(C++11)

atomic_fetch_subatomic_fetch_sub_explicit (C++11)(C++11)

atomic_fetch_andatomic_fetch_and_explicit (C++11)(C++11)

atomic_fetch_oratomic_fetch_or_explicit (C++11)(C++11)

atomic_fetch_xoratomic_fetch_xor_explicit (C++11)(C++11)

atomic_is_lock_free (C++11)

atomic_waitatomic_wait_explicit (C++20)(C++20)

atomic_notify_one (C++20)

atomic_notify_all (C++20)

Атомарные флаги

atomic_flag (C++11)

atomic_flag_test_and_setatomic_flag_test_and_set_explicit (C++11)(C++11)

atomic_flag_clearatomic_flag_clear_explicit (C++11)(C++11)

atomic_flag_testatomic_flag_test_explicit (C++20)(C++20)

atomic_flag_waitatomic_flag_wait_explicit (C++20)(C++20)

atomic_flag_notify_one (C++20)

atomic_flag_notify_all (C++20)

Инициализация

atomic_init (C++11)(устарело в C++20)

ATOMIC_VAR_INIT (C++11)(устарело в C++20)

ATOMIC_FLAG_INIT (C++11)(устарело в C++20)

Упорядочивание доступа к памяти

memory_order (C++11)

kill_dependency (C++11)

atomic_thread_fence (C++11)

atomic_signal_fence (C++11)

 

std::atomic

Функции-элементы

atomic::atomic

atomic::operator=

atomic::is_lock_free

atomic::store

atomic::load

atomic::operator T

atomic::exchange

atomic::compare_exchange_strongatomic::compare_exchange_weak

atomic::wait (C++20)

atomic::notify_one (C++20)

atomic::notify_all (C++20)

Константы

atomic::is_always_lock_free (C++17)

Специализированные функции-элементы

atomic::fetch_add

atomic::fetch_sub

atomic::fetch_and

atomic::fetch_or

atomic::fetch_xor

atomic::operator++atomic::operator++(int)atomic::operator--atomic::operator--(int)

atomic::operator+=atomic::operator-=atomic::operator&=atomic::operator|=atomic::operator^=

 

<tbody> </tbody>

T fetch_add( T arg, std::memory_order order = std::memory_order_seq_cst ); T fetch_add( T arg, std::memory_order order = std::memory_order_seq_cst ) volatile;		(Только для специализации шаблона atomic<Integral>) (начиная с C++11)
T* fetch_add( std::ptrdiff_t arg, std::memory_order order = std::memory_order_seq_cst ); T* fetch_add( std::ptrdiff_t arg, std::memory_order order = std::memory_order_seq_cst ) volatile;		(Только для специализации шаблона atomic<T*>) (начиная с C++11)

Атомарно заменяет текущее значение результатом арифметического сложения значения и arg. Операция атомарного изменения (read-modify-write). Обращения к памяти происходят в соответствии со значением order.

Для знаковых интегральных (Integral) типов используется арифметика дополнительного кода. Результат всегда определен. Для типов T* результат может быть неопределенным адресом, но сама операция не приводит к неопределенному поведению.

Параметры

arg	—	Второе слагаемое арифметического сложения
memory_order	—	Ограничения порядка доступа к памяти

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

Значение атомарной переменной до вызова.

Исключения

спецификация noexcept:  

noexcept

  

Пример

Запустить этот код

#include <iostream>
#include <thread>
#include <atomic>

std::atomic<long long> data;
void do_work()
{
    data.fetch_add(1, std::memory_order_relaxed);
}

int main()
{
    std::thread th1(do_work);
    std::thread th2(do_work);
    std::thread th3(do_work);
    std::thread th4(do_work);
    std::thread th5(do_work);
    
    th1.join();
    th2.join();
    th3.join();
    th4.join();
    th5.join();

    std::cout << "Result:" << data << '\n';
}

Вывод:

Result:5

См. также

atomic_fetch_addatomic_fetch_add_explicit (C++11)(C++11)

добавляет неатомарное значение к атомарному объекту и получает предыдущее атомарное значение (шаблон функции)