最終更新日時: 2025年07月12日 02時16分44秒 (JST)
Koichi Murase が更新

履歴 編集

function template
<mutex>

# std::unique_lock::try_lock_until(C++11)

    template <class Clock, class Duration>
    bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);

## 概要

タイムアウトする絶対時間を指定してロックの取得を試みる

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

- `Mutex`型が、`try_lock_until()`メンバ関数をサポートするミューテックス型であること
- `chrono::is_clock_v<Clock>`が`true`であること (C++20)

## 効果

    pm->try_lock_until(abs_time);

※`pm`はメンバ変数として保持している、ミューテックスオブジェクトへのポインタ

## 事後条件

`owns_lock()`の値が、`pm->try_lock_until(abs_time)`の戻り値になること

## 戻り値

`pm->try_lock_until(abs_time)`の戻り値が返る

## 例外

この関数は、`pm->try_lock_until()` 関数内で投げられうるあらゆる例外を投げる可能性がある。

そのほかに、以下のerror conditionを持つ`system_error` 例外オブジェクトを送出する可能性がある：

- `operation_not_permitted` ： `pm`が`NULL`
- `resource_deadlock_would_occur` ： `owns_lock() == true`の状態でこの関数が呼び出された

## 例

    #include <iostream>
    #include <thread>
    #include <mutex>
    #include <chrono>
    #include <system_error>

    class X {
      std::timed_mutex mtx_;
      int value_ = 0;
    public:
      // メンバ変数value_への書き込みを排他的にする
      void add_value(int value)
      {
        std::unique_lock<std::timed_mutex> lk(mtx_, std::defer_lock);

        namespace chrono = std::chrono;
        chrono::system_clock::time_point tp = chrono::system_clock::now();

        // ロックの取得を試みる(3秒後にタイムアウト)
        if (!lk.try_lock_until(tp + chrono::seconds(3))) {
          // ロックの取得に失敗
          std::error_code ec(static_cast<int>(std::errc::device_or_resource_busy), std::generic_category());
          throw std::system_error(ec);
        }
        value_ = value;
      }
    };

    int main()
    {
      X x;

      std::thread t1([&x]{ x.add_value(1); });
      std::thread t2([&x]{ x.add_value(2); });

      t1.join();
      t2.join();
    }

### 出力

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅, 2015 ✅
  - 2012, 2013は、例外の節で説明している`system_error`を投げる処理が実装されていない。

## 参照