4. atomic_store_explicit

最終更新日時(UTC):
が更新

履歴 編集

function template
<atomic>

std::atomic_store_explicit(C++11)

namespace std {
  template <class T>
  void atomic_store_explicit(
         volatile atomic<T>* object,
         T desired,
         memory_order order) noexcept;           // (1) C++11

  template <class T>
  void atomic_store_explicit(
         volatile atomic<T>* object,
         typename atomic<T>::value_type desired,
         memory_order order) noexcept;           // (1) C++17

  template <class T>
  void atomic_store_explicit(
         atomic<T>* object,
         T desired,
         memory_order order) noexcept;           // (2) C++11

  template <class T>
  void atomic_store_explicit(
         atomic<T>* object,
         typename atomic<T>::value_type desired,
         memory_order order) noexcept;           // (2) C++17
}

概要

アトミックに値を書き込む

テンプレートパラメータ制約

  • (1) :
    • C++20 : atomic<T>::is_always_lock_freeがtrueであること

効果

指定されたメモリオーダーにしたがって、objectが指す値をdesiredでアトミックに置き換える。

この関数は、戻り値のないatomic_exchange_explicit()と見なせる。

戻り値

なし

例外

投げない

備考

この関数は、特殊化されたatomic型に対して定義される。

例

#include <iostream>
#include <atomic>

int main()
{
  std::atomic<int> x(3);

  // 2を書き込む
  std::atomic_store_explicit(&x, 2, std::memory_order_release);

  std::cout << x.load() << std::endl;
}

出力

2

バージョン

言語

  • C++11

処理系

関連項目

参照