Namespaces
Variants

atomic_load, atomic_load_explicit

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

以原子方式加载并返回指向 obj 的原子变量的当前值。该操作是原子读操作。

第一个版本按照 memory_order_seq_cst 排序内存访问,第二个版本按照 order 参数排序内存访问。 order 必须是 memory_order_relaxed memory_order_consume memory_order_acquire memory_order_seq_cst 之一,否则行为未定义。

这是一个为所有 A 类型 原子对象 定义的 泛型函数 。该参数是指向volatile原子类型的指针,用于接受非volatile和 volatile (例如内存映射I/O)原子对象的地址,当对volatile原子对象应用此操作时,volatile语义会被保留。 C 是与 A 对应的非原子类型。

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

目录

参数

obj - 指向要访问的原子对象的指针
order - 此操作的内存同步排序方式

返回值

指向 obj 的原子变量的当前值。

参考文献

  • C17 标准 (ISO/IEC 9899:2018):
  • 7.17.7.2 原子加载通用函数 (p: 206)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.17.7.2 atomic_load 泛型函数 (p: 282)

参见

在原子对象中存储值
(函数)
C++ 文档 关于 atomic_load , atomic_load_explicit