atomic_flag_clear_explicit.md

atomic_flag_clear_explicit

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

namespace std {
  void atomic_flag_clear_explicit(volatile atomic_flag* object, memory_order order) noexcept;
  void atomic_flag_clear_explicit(atomic_flag* object, memory_order order) noexcept;
}

• atomic_flag[link atomic_flag.md]
• memory_order[link memory_order.md]

概要

アトミックにフラグをクリアする

要件

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

• memory_order_consume (C++14)
• memory_order_acquire
• memory_order_acq_rel

効果

orderで指定されたメモリオーダーにしたがって、アトミックにfalse値を書き込む。

戻り値

なし

例外

投げない

例

#include <iostream>
#include <atomic>

int main()
{
  std::atomic_flag x = ATOMIC_FLAG_INIT;

  std::cout << std::boolalpha;
  {
    // 値をtrueに設定する(変更前の値はfalse)
    bool result = std::atomic_flag_test_and_set_explicit(&x, std::memory_order_acq_rel);
    std::cout << result << std::endl;
  }

  // 値をfalseにする
  std::atomic_flag_clear_explicit(&x, std::memory_order_release);

  {
    // 値をtrueに設定する(変更前の値はfalse)
    bool result = std::atomic_flag_test_and_set_explicit(&x, std::memory_order_acq_rel);
    std::cout << result << std::endl;
  }
}

• std::atomic_flag_clear_explicit[color ff0000]
• std::atomic_flag[link atomic_flag.md]
• ATOMIC_FLAG_INIT[link atomic_flag_init.md]
• std::atomic_flag_test_and_set_explicit[link atomic_flag_test_and_set_explicit.md]

出力

false
false

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC: 4.7.0
• ICC: ??
• Visual C++: 2012, 2013

参照

• LWG Issue 2138. atomic_flag::clear should not accept memory_order_consume