Namespaces
Variants

atomic_fetch_and, atomic_fetch_and_explicit

From cppreference.net
定义于头文件 <stdatomic.h>
C atomic_fetch_and ( volatile A * obj, M arg ) ;
(1) (C11 起)
C atomic_fetch_and_explicit ( volatile A * obj, M arg, memory_order order ) ;
(2) (C11 起)

以原子方式将 obj 指向的值替换为 obj 旧值与 arg 的按位与结果,并返回 obj 先前持有的值。该操作是读-修改-写操作。第一个版本按照 memory_order_seq_cst 对内存访问进行排序,第二个版本按照 order 参数对内存访问进行排序。

这是一个为所有 原子对象类型 A 定义的 泛型函数 。参数为指向易变原子类型的指针,用于接受非易变和 易变 (如内存映射I/O)原子对象的地址,当对易变原子对象应用此操作时保留易变语义。若 A 为原子整型类型,则 M 为对应 A 的非原子类型;若 A 为原子指针类型,则 M ptrdiff_t

未指定泛型函数的名称是宏还是具有外部链接的标识符。若为访问实际函数而抑制宏定义(例如采用括号形式如 ( atomic_fetch_and ) ( ... ) ),或程序定义了与泛型函数同名的外部标识符,则行为未定义。

目录

参数

obj - 指向要修改的原子对象的指针
arg - 要与原子对象中存储的值进行按位与运算的值
order - 此操作的内存同步顺序:允许所有取值

返回值

原子对象 obj 先前持有的值。

参考文献

  • C17 标准 (ISO/IEC 9899:2018):
  • 7.17.7.5 原子获取与修改通用函数 (p: 208)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.17.7.5 atomic_fetch 和 modify 通用函数 (p: 284-285)

参见

原子按位或运算
(函数)
原子按位异或运算
(函数)
C++ 文档 关于 atomic_fetch_and , atomic_fetch_and_explicit