std::atomic_is_lock_free, ATOMIC_xxx_LOCK_FREE
来自 cppreference.com
| 在头文件 <atomic> 中定义 |
||
| template< class T > bool atomic_is_lock_free( const volatile std::atomic<T>* obj ) noexcept; |
(1) | (自 C++11 起) |
| template< class T > bool atomic_is_lock_free( const std::atomic<T>* obj ) noexcept; |
(2) | (自 C++11 起) |
| #define ATOMIC_BOOL_LOCK_FREE /* 未指定 */ #define ATOMIC_CHAR_LOCK_FREE /* 未指定 */ |
(3) | (自 C++11 起) |
| #define ATOMIC_CHAR8_T_LOCK_FREE /* 未指定 */ |
(4) | (自 C++20 起) |
1,2) 确定由 obj 指向的原子对象是否以无锁方式实现，如同调用 obj->is_lock_free()。在任何给定的程序执行中，对所有相同类型的原子对象，无锁查询的结果都是相同的。
3,4) 展开为一个整型常量表达式，其值为
- 0 用于永远不会是无锁的内置原子类型，
- 1 用于有时是无锁的内置原子类型，
- 2 用于始终是无锁的内置原子类型。
内容 |
[编辑] 参数
| obj | - | 指向要检查的原子对象的指针 |
[编辑] 返回值
如果 *obj 是无锁原子，则为 true，否则为 false。
[编辑] 备注
除了 std::atomic_flag 之外的所有原子类型都可以使用互斥锁或其他锁定操作来实现，而不是使用无锁原子 CPU 指令。原子类型也可以有时是无锁的：例如，如果只有某些子体系结构支持对给定类型的无锁原子访问（例如，x86-64 上的 CMPXCHG16B 指令），则在运行时之前可能无法知道原子是否为无锁。
C++ 标准建议（但不要求）无锁原子操作也是无地址的，也就是说，适合使用共享内存进行进程间通信。
[编辑] 示例
运行此代码
#include <atomic> #include <iostream> #include <utility> struct A { int a[100]; }; struct B { int x, y; }; int main() { std::atomic<A> a; std::atomic<B> b; std::cout << std::boolalpha << "std::atomic<A> is lock free? " << std::atomic_is_lock_free(&a) << '\n' << "std::atomic<B> is lock free? " << std::atomic_is_lock_free(&b) << '\n'; }
可能的输出
std::atomic<A> is lock free? false std::atomic<B> is lock free? true
[编辑] 缺陷报告
以下行为更改缺陷报告已追溯应用于先前发布的 C++ 标准。
| DR | 应用于 | 已发布的行为 | 正确行为 |
|---|---|---|---|
| LWG 3249 | C++11 | atomic_is_lock_free 是通过指针指定的，这模棱两可，可能接受无效的指针值 |
通过 原子对象 |
[编辑] 参见
| 检查原子对象是否为无锁 ( std::atomic<T> 的公共成员函数) | |
| (C++11) |
无锁布尔原子类型 (类) |
| [静态] (C++17) |
指示该类型始终为无锁 ( std::atomic<T> 的公共静态成员常量) |
| (C++20 中已弃用)(C++26 中已移除) |
为 std::shared_ptr 特化原子操作 (函数模板) |
| C 文档 for atomic_is_lock_free
| |
| C 文档 for ATOMIC_*_LOCK_FREE
| |
