# std::shared_lock<Mutex>::try_lock

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

Tries to lock the associated mutex in shared mode without blocking. Effectively calls mutex()->try_lock_shared().

## Official Specification Summary (cppreference)

```cpp
bool try_lock(); // (since C++14)
```

Tries to lock the associated mutex in shared mode without blocking. Effectively calls `mutex()->try_lock_shared()`.

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

### Parameters

(none)

### Return value

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

### Exceptions

- Any exceptions thrown by `mutex()->try_lock_shared()`.

- 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/unique_lock/try_lock): tries to lock (i.e., takes ownership of) the associated mutex without blocking (public member function of `std::unique_lock<Mutex>`)
- [`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)
- [`try_lock_until`](https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock_until): tries to lock the associated mutex, until a specified time point (public member function)
- [`unlock`](https://en.cppreference.com/w/cpp/thread/shared_lock/unlock): unlocks the associated mutex (public member function)

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