test_and_set.md

test_and_set

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

bool
  test_and_set(memory_order order = memory_order_seq_cst
               ) volatile noexcept;                      // (1) C++11

bool
  test_and_set(memory_order order = memory_order_seq_cst
               ) noexcept;                               // (2) C++11
constexpr bool
  test_and_set(memory_order order = memory_order_seq_cst
               ) noexcept;                               // (2) C++26

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

概要

テストしてフラグを立てる

効果

orderで指定されたメモリオーダーにしたがって、アトミックにtrue値を書き込む。この操作はread-modify-write操作である。

戻り値

変更前の値

例外

投げない

例

#include <iostream>
#include <atomic>

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

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

• test_and_set[color ff0000]
• std::atomic_flag[link /reference/atomic/atomic_flag.md]
• ATOMIC_FLAG_INIT[link /reference/atomic/atomic_flag_init.md]

出力

false
true

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC: 4.7.0 [mark verified]
• ICC: ??
• Visual C++: 2012 [mark verified], 2013 [mark verified]

参照

• P3309R3 constexpr atomic and atomic_ref
  • C++26でconstexprに対応した