C++ 原子库 - Fetch Sub


描述

它从原子对象中减去非原子值并获得原子的先前值。

宣言

以下是 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 的修改顺序返回紧邻该函数效果之前的值。

例外情况

No-noexcept - 该成员函数从不抛出异常。

例子

在下面的 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
............................
原子.htm