# std::shared_lock<Mutex>::try_lock_until

> C++ Atlas: `cppatlas.com/w/cpp/thread/shared_lock/try_lock_until` | Source: https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock_until | Domain: Concurrency support | Standards: C++14, C++20

Tries to lock the associated mutex in shared mode. Blocks until specified timeout_time has been reached or the lock is acquired, whichever comes first.

## Official Specification Summary (cppreference)

```cpp
template< class Clock, class Duration >
bool try_lock_until( const std::chrono::time_point<Clock,Duration>& timeout_time ); // (since C++14)
```

Tries to lock the associated mutex in shared mode. Blocks until specified `timeout_time` has been reached or the lock is acquired, whichever comes first. On successful lock acquisition returns `true`, otherwise returns `false`. May block for longer than until `timeout_time` has been reached.

Effectively calls `mutex()->try_lock_shared_until(timeout_time)`.

`std::system_error` is thrown if there is no associated mutex or if the mutex is already locked.

`Clock` must meet the *Clock* requirements. The behavior is undefined if `Mutex` does not meet the *SharedTimedLockable* requirements. The program is ill-formed if `std::chrono::is_clock_v<Clock>` is `false`. (since C++20)

### Parameters

- `timeout_time` - maximum time point to block until

### Return value

`true` if the ownership of the mutex has been acquired successfully, `false` otherwise.

### Exceptions

- Any exceptions thrown by `mutex()->try_lock_shared_for(timeout_time)`.

- If there is no associated mutex, `std::system_error` with an error code of `std::errc::operation_not_permitted`.

- If the mutex is already locked, `std::system_error` with an error code of `std::errc::resource_deadlock_would_occur`.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`lock`](https://en.cppreference.com/w/cpp/thread/shared_lock/lock): locks the associated mutex (public member function)
- [`try_lock`](https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock): tries to lock the associated mutex (public member function)
- [`try_lock_for`](https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock_for): tries to lock the associated mutex, for the specified duration (public member function)
- [`unlock`](https://en.cppreference.com/w/cpp/thread/shared_lock/unlock): unlocks the associated mutex (public member function)
- [`try_lock_until`](https://en.cppreference.com/w/cpp/thread/unique_lock/try_lock_until): tries to lock (i.e., takes ownership of) the associated *TimedLockable* mutex, returns if the mutex has been unavailable until specified time point has been reached (public member function of `std::unique_lock<Mutex>`)

---
Attribution: content from https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock_until (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.