最終更新日時: 2024年06月11日 22時45分38秒 (JST)
Akira Takahashi が更新

履歴 編集

function template
<shared_mutex>

# std::shared_lock::try_lock_until(C++14)

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

## 概要

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

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

- `chrono::is_clock_v<Clock>`が`true`であること (C++20)

## 効果

    pm->try_lock_until_shared(abs_time);

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

## 事後条件

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

## 戻り値

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

## 例外

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

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

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

## 例

    #include <cassert>
    #include <system_error>
    #include <chrono>
    #include <shared_mutex>

    int main()
    {
      std::shared_timed_mutex mtx;
      {
        // 遅延ロックする(ここではロックを取得しない)
        std::shared_lock<std::shared_timed_mutex> lock(mtx, std::defer_lock);

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

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

        assert(lock.owns_lock() == true);
      }
    }

### 出力

## バージョン

### 言語

- C++14

### 処理系

- Clang: 3.5 ✅
- GCC: 4.9 ✅
- ICC: ??
- Visual C++: 2015 ✅