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
. Аргументом является указатель на volatile атомарный тип для принятия адресов как не-volatile, так и
volatile
(например, отображённых в память I/O) атомарных объектов, и семантика volatile сохраняется при применении этой операции к volatile атомарным объектам.
M
является либо неатомарным типом, соответствующим
A
, если
A
является атомарным целочисленным типом, либо
ptrdiff_t
, если
A
является атомарным типом указателя.
Не определено, является ли имя обобщённой функции макросом или идентификатором, объявленным с внешней линковкой. Если определение макроса подавляется для доступа к реальной функции (например, заключено в скобки как ( atomic_fetch_xor ) ( ... ) ), или программа определяет внешний идентификатор с именем обобщённой функции, поведение не определено.
Содержание |
Параметры
| obj | - | указатель на атомарный объект для модификации |
| arg | - | значение для побитового XOR со значением, хранящимся в атомарном объекте |
| order | - | порядок синхронизации памяти для этой операции: допустимы все значения |
Возвращаемое значение
Значение, которое ранее содержал атомарный объект, на который указывает
obj
.
Ссылки
- Стандарт C17 (ISO/IEC 9899:2018):
-
- 7.17.7.5 Универсальные функции atomic_fetch и modify (стр. 208)
- Стандарт C11 (ISO/IEC 9899:2011):
-
- 7.17.7.5 Универсальные функции atomic_fetch и modify (стр: 284-285)
Смотрите также
|
атомное побитовое ИЛИ
(функция) |
|
|
атомное побитовое И
(функция) |
|
|
Документация C++
для
atomic_fetch_xor
,
atomic_fetch_xor_explicit
|
|