atomic_store_explicit.md

atomic_store_explicit

• memory[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp11[meta cpp]

namespace std {
  template<class T>
  void atomic_store_explicit(shared_ptr<T>* p, shared_ptr<T> r, memory_order order);
}

• memory_order[link /reference/atomic/memory_order.md]

概要

メモリオーダーを指定して、shared_ptrオブジェクトに、アトミックに値を書き込む。

要件

p != nullptrであること。

orderが以下のメモリオーダーではないこと：

• memory_order_acquire
• memory_order_acq_rel

効果

p->swap(r)相当のことを、アトミックに実行する。

戻り値

なし

例外

投げない

例

#include <iostream>
#include <memory>

int main()
{
  std::shared_ptr<int> p;

  // pにxをアトミックに書き込む
  std::shared_ptr<int> x(new int(3));
  std::atomic_store_explicit(&p, x, std::memory_order_release);

  // pが指すshared_ptrオブジェクトを、アトミックに読み込む
  std::shared_ptr<int> result = std::atomic_load_explicit(
                                    &p, std::memory_order_acquire);
  std::cout << *result << std::endl;
}

• std::atomic_store_explicit[color ff0000]
• std::atomic_load_explicit[link atomic_load_explicit.md]

出力

3

バージョン

言語

• C++11

処理系

• Clang, C++11 mode: 3.3
• GCC, C++11 mode: 5.0
• ICC: ??
• Visual C++: 2012, 2013

参照

• atomic_store() - shared_ptr
• atomic_store_explicit() - <atomic>
• N2674 Shared_ptr atomic access, revision 1
• C++0x Shared_ptr atomic access - Faith and Brave - C++で遊ぼう