std::atomic_fetch_sub,std::atomic_fetch_sub_explicit
来自 cppreference.com
定义在头文件 <atomic> 中 |
||
template< class T > T atomic_fetch_sub( std::atomic<T>* obj, |
(1) | (自 C++11 起) |
template< class T > T atomic_fetch_sub( volatile std::atomic<T>* obj, |
(2) | (自 C++11 起) |
template< class T > T atomic_fetch_sub_explicit( std::atomic<T>* obj, |
(3) | (自 C++11 起) |
template< class T > T atomic_fetch_sub_explicit( volatile std::atomic<T>* obj, |
(4) | (自 C++11 起) |
执行原子减法。原子地从 obj 指向的值中减去 arg,并返回 obj 之前持有的值。该操作的执行方式与执行以下操作相同
1,2) obj->fetch_sub(arg)
3,4) obj->fetch_sub(arg, order)
如果 std::atomic<T>
没有 fetch_sub
成员(此成员仅提供给 整数, 浮点数(自 C++20 起) 和 指针 类型,除了 bool),程序格式错误。
内容 |
[编辑] 参数
obj | - | 指向要修改的原子对象的指针 |
arg | - | 要从原子对象中存储的值中减去的值 |
order | - | 内存同步排序 |
[编辑] 返回值
在 *obj 的 修改顺序 中,紧接此函数效果之前的那个值。
[编辑] 示例
多个线程可以使用 std::atomic_fetch_sub
来并发处理索引容器。
运行此代码
#include <atomic> #include <iostream> #include <numeric> #include <string> #include <thread> #include <vector> const int N = 50; std::atomic<int> cnt; std::vector<int> data(N); void reader(int id) { for (;;) { int idx = atomic_fetch_sub_explicit(&cnt, 1, std::memory_order_relaxed); if (idx >= 0) std::cout << "reader " << std::to_string(id) << " processed item " << std::to_string(data[idx]) << '\n'; else { std::cout << "reader " << std::to_string(id) << " done\n"; break; } } } int main() { std::iota(data.begin(), data.end(), 1); cnt = data.size() - 1; std::vector<std::thread> v; for (int n = 0; n < 5; ++n) v.emplace_back(reader, n); for (auto& t : v) t.join(); }
输出
reader 2 processed item 50 reader 1 processed item 44 reader 4 processed item 46 <....> reader 0 done reader 4 done reader 3 done
[编辑] 缺陷报告
以下行为更改缺陷报告被追溯应用于之前发布的 C++ 标准。
DR | 应用于 | 发布时的行为 | 正确行为 |
---|---|---|---|
P0558R1 | C++11 | 需要精确类型匹配,因为T 从多个参数中推断 |
T 仅从 obj 推断从 obj 推断 |
[编辑] 参见
原子地从存储在原子对象中的值中减去参数,并获取之前持有的值 ( std::atomic<T> 的公有成员函数) | |
(C++11)(C++11) |
将非原子值添加到原子对象,并获取原子对象的先前值 (函数模板) |
C 文档 用于 atomic_fetch_sub, atomic_fetch_sub_explicit
|