atomic_fetch_add_explicit

atomic_fetch_add, atomic_fetch_add_explicit

在头文件中定义
C atomic_fetch_add（volatile A * obj，M arg）;	(1)	（自C11以来）
C atomic_fetch_add_explicit（volatile A * obj，M arg，memory_order order）;	(2)	（自C11以来）

原子替换指向的值obj和添加arg到旧值的结果obj，并返回obj先前保存的值。操作是读取 - 修改 - 写入操作。第一个版本根据命令对内存进行访问memory_order_seq_cst，第二个版本根据内存访问内存访问order。

这是为所有原子对象类型定义的通用函数A。该参数是指向易失性原子类型的指针，以接受非易失性和易失性（例如内存映射I/O）原子变量的地址。M或者是对应于非原子类型A，如果A是原子整数类型，或者ptrdiff_t如果A是原子指针类型。

对于有符号整数类型，算术定义为使用二进制补码表示。没有未定义的结果。对于指针类型，结果可能是一个未定义的地址，但操作没有未定义的行为。

参数

obj	-	指向要修改的原子对象的指针
arg	-	要添加到存储在原子对象中的值的值
order	-	此操作的内存同步排序：所有值都是允许的

返回值

之前保存的值是指向的原子对象obj。

示例

#include <stdio.h>
#include <threads.h>
#include <stdatomic.h>
 
atomic_int acnt;
int cnt;
 
int f(void* thr_data)
{
    for(int n = 0; n < 1000; ++n) {
        atomic_fetch_add_explicit(&acnt, 1, memory_order_relaxed // atomic
        ++cnt; // undefined behavior, in practice some updates missed
    }
    return 0;
}
 
int main(void)
{
    thrd_t thr[10];
    for(int n = 0; n < 10; ++n)
        thrd_create(&thr[n], f, NULL
    for(int n = 0; n < 10; ++n)
        thrd_join(thr[n], NULL
 
    printf("The atomic counter is %u\n", acnt
    printf("The non-atomic counter is %u\n", cnt
}

可能的输出：

The atomic counter is 10000
The non-atomic counter is 9511

参考

C11标准（ISO/IEC 9899:2011）：

另请参阅

atomic_fetch_subatomic_fetch_sub_explicit (C11)	atomic subtraction (function)

| atomic_fetch_add，atomic_fetch_add_explicit的C ++文档 |