C++ 原子库 - 提取并减

描述

从原子对象中减去一个非原子值，并获取原子对象的先前值。

声明

以下是 std::atomic_fetch_sub 的声明。

template< class Integral >
Integral atomic_fetch_sub( volatile std::atomic<Integral>* obj, Integral arg );

C++11

template< class Integral >
Integral atomic_fetch_sub( std::atomic<Integral>* obj, Integral arg );

以下是 std::atomic_fetch_sub_explicit 的声明。

template< class T >
T* atomic_fetch_sub_explicit( volatile std::atomic<T*>* obj, std::ptrdiff_t arg, 
                              std::memory_order order )

C++11

template< class T >
T* atomic_fetch_sub_explicit( std::atomic<T*>* obj, std::ptrdiff_t arg, 
                              std::memory_order order );

参数

• obj − 用于指向要修改的原子对象。

• desr − 用于存储原子对象中的值。

• order − 用于同步此操作的内存顺序。

返回值

它返回在 *obj 的修改顺序中紧接在此函数效果之前的数值。

异常

无异常 - 此成员函数从不抛出异常。

示例

以下示例演示 std::atomic_fetch_sub_explicit 的用法。

#include <string>
#include <thread>
#include <vector>
#include <iostream>
#include <atomic>
#include <numeric>
 
const int N = 10000;
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 < 10; ++n) {
      v.emplace_back(reader, n);
   }
   for (auto& t : v) {
      t.join();
   }
}

输出应如下所示：

reader 1 processed item 9997
reader 1 processed item 9992
reader 1 processed item 9991
reader 1 processed item 9990
reader 1 processed item 9989
reader 1 processed item 9988
reader 1 processed item 9987
reader 1 processed item 9986
reader 1 processed item 9985
reader 1 processed item 9984
reader 1 processed item 9983
reader 1 processed item 9982
reader 1 processed item 9981
reader 1 processed item 9980
reader 1 processed item 9979
reader 1 processed item 9978
reader 1 processed item 9977
reader 1 processed item 9976
reader 1 processed item 9975
reader 1 processed item 9974
reader 1 processed item 9973
............................