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)
См. также
|
(C11) |
побитовое OR (функция) |
|
(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