Spec-Zone.ru › C

atomic_fetch_xor, atomic_fetch_xor_explicit

Определено в заголовочном файле <stdatomic.h>
C atomic_fetch_xor( volatile A* obj, M arg );
(1) (с C11)
C atomic_fetch_xor_explicit( volatile A* obj, M arg, memory_order order );
(2) (с C11)

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

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

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

Параметры

obj - указатель на атомный объект для изменения
arg - значение для побитового XOR со значением, хранящимся в атомном объекте
order - упорядочение синхронизации памяти для этой операции: все значения допустимы

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

Значение, которое ранее хранилось в атомном объекте, на который указывает 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)

См. также

atomic_fetch_oratomic_fetch_or_explicit
(C11)
побитовое OR
(функция)
atomic_fetch_andatomic_fetch_and_explicit
(C11)
побитовое AND
(функция)
Документация C++ для atomic_fetch_xor, atomic_fetch_xor_explicit

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/atomic/atomic_fetch_xor

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API