atomic_fetch_and, atomic_fetch_and_explicit

C atomic_fetch_and( volatile A* obj, M arg );

C atomic_fetch_and_explicit( volatile A* obj, M arg, memory_order order );

Атомарно заменяет значение, на которое указывает obj, результатом поразрядной операции AND между старым значением obj и arg, и возвращает ранее хранившееся значение obj. Данная операция является операцией "чтение-модификация-запись". Первый вариант упорядочивает обращения к памяти в соответствии с memory_order_seq_cst, а второй — в соответствии с order.

Это общая функция, определённая для всех атомных типов данных A. Аргумент — указатель на переменную volatile атомного типа, принимающий адреса как не-volatile, так и volatile (например, памяти с отображением ввода-вывода) атомных объектов, и семантика volatile сохраняется при применении этой операции к volatile атомным объектам. M — это либо неатомный тип, соответствующий A, если A — атомный целочисленный тип, либо ptrdiff_t, если A — атомный указательный тип.

Неопределено, является ли имя общей функции макросом или идентификатором, объявленным с внешней связью. Если определение макроса подавлено для доступа к фактической функции (например, в скобках, как в (atomic_fetch_and)(...)), или программа определяет внешний идентификатор с именем общей функции, поведение является неопределённым.

Параметры

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

Значение, которое хранилось в атомном объекте, на который указывает obj.

Ссылки

• Стандарт C17 (ISO/IEC 9899:2018):
• 7.17.7.5 Общие функции atomic_fetch и модификации (с. 208)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.17.7.5 Общие функции atomic_fetch и модификации (с. 284-285)

См. также