atomic_add_value()

Безопасно прибавить число к переменной и вернуть исходное значение переменной

Прототип:

#include <atomic.h>
unsigned atomic_add_value( volatile unsigned *loc,
unsigned incr );

Аргументы:

loc
Указатель на переменную к которой требуется прибавить число.
incr
Число, которое требуется прибавить.

Библиотека:

libc

Описание:

Функция atomic_add_value() представляет собой потокобезопасный способ выполнения операции (*loc) += incr, даже в системах с симметричной многопроцессорностью.


Note: Функция atomic_add_value() может быть медленнее чем atomic_add().

Функции atomic_*() гарантировано выполняются без вытеснения другим потоком. При модификации переменной совместно используемой в потоке и прерываниях, необходимо либо запрещать прерывания, либо использовать функции atomic_*().

Функции atomic_*() полезны для модификации переменной используемой в нескольких потоках (которые не обязательно принадлежат одному процессу) без необходимости в использовании мьютекса.


Caution: Производите атомарные операции только с объектами находящимися в памяти с нормальным маппированием. На определённых процессорах (например некоторые PPC) атомарные операции будут вызывать сбои, если объект находится в памяти без кэширования.

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

Предыдущее значение находившееся в loc.

Примеры:

Безопасное увеличение значения счётчика совместно используемого в нескольких потоках:

#include <atomic.h>
...
volatile unsigned count;
unsigned previous;
...
previous = atomic_add_value( &count, 1 );

Классификация:

ЗОСРВ «Нейтрино»

Точка остановки потока
Нет
Обработчик прерываний
Да
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

atomic_add(), atomic_clr(), atomic_clr_value(), atomic_set(), atomic_set_value(), atomic_sub(), atomic_sub_value(), atomic_toggle(), atomic_toggle_value()




Предыдущий раздел: Описание API системной библиотеки