std::atomic_fetch_xor, std::atomic_fetch_xor_explicit

< cpp‎ | atomic
 
C++
 
原子操作库
类
(C++11)
(C++20)
函数
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
atomic_fetch_xoratomic_fetch_xor_explicit
(C++11)(C++11)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志
(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
内存顺序
(C++11)
(C++11)
(C++11)
(C++11)
 
定义于头文件 <atomic>
(1) (C++11 起)
template< class T >

T atomic_fetch_xor( std::atomic<T>* obj,

                    typename std::atomic<T>::value_type arg ) noexcept;
template< class T >

T atomic_fetch_xor( volatile std::atomic<T>* obj,

                    typename std::atomic<T>::value_type arg ) noexcept;
(2) (C++11 起)
template< class T >

T atomic_fetch_xor_explicit( std::atomic<T>* obj,
                             typename std::atomic<T>::value_type arg,

                             std::memory_order order) noexcept;
template< class T >

T atomic_fetch_xor_explicit( volatile std::atomic<T>* obj,
                             typename std::atomic<T>::value_type arg,

                             std::memory_order order) noexcept;

原子地以 obj 的旧值和 arg 的逐位异或结果替换 obj 所指向的值。返回 obj 先前保有的值。

如同执行下列内容一般进行运算：

1) obj->fetch_xor(arg)
2) obj->fetch_xor(arg, order)

若 std::atomic<T> 无 fetch_xor 成员（此成员仅对整数类型提供），则程序为病式。

参数

obj - 指向要修改的原子对象的指针
arg - 要和存储于原子对象的值逐位异或的值
order - 此操作所用的内存同步书顺序：容许所有值。

返回值

*obj 的修改顺序中立即前趋此函数效果的值。

可能的实现

template< class T >
T atomic_fetch_xor( std::atomic<T>* obj, typename std::atomic<T>::value_type arg )
{
    return obj->fetch_xor(arg);
}

示例

本节未完成
原因：暂无示例

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR 应用于 出版时的行为 正确行为
P0558R1 C++11 曾要求准确类型匹配，因为从多个参数推导 T 仅从 atomic 参数推导 T

参阅

 原子地进行参数和原子对象的值的逐位异或，并获得先前保有的值
(std::atomic<T> 的公开成员函数)
(C++11)(C++11)
 将原子对象替换为与非原子实参逻辑或的结果，并获得原子对象的先前值
(函数模板)
(C++11)(C++11)
 将原子对象替换为与非原子实参逻辑与的结果，并获得原子对象的先前值
(函数模板)