# C++ named requirements: SharedTimedLockable (since C++14)

> C++ Atlas: `cppatlas.com/w/cpp/named_req/SharedTimedLockable` | Source: https://en.cppreference.com/w/cpp/named_req/SharedTimedLockable | Domain: Named Requirements | Standards: C++14

The SharedTimedLockable requirements describe the characteristics of types that provide timed shared blocking semantics for execution agents (threads, processes, tasks).

## Official Specification Summary (cppreference)

The *SharedTimedLockable* requirements describe the characteristics of types that provide timed shared blocking semantics for execution agents (threads, processes, tasks).

### Requirements

- *SharedLockable*

For type `L` to be *SharedTimedLockable*, given

- `rel_time`, a value of a specialization of `std::chrono::duration`, and
- `abs_time`, a value of a specialization of `std::chrono::time_point`,

the following conditions have to be satisfied for an object `m` of type `L`:

| Expression | Requires | Return value |
| --- | --- | --- |
| `m.try_lock_shared_for(rel_time)` | Blocks for the provided duration `rel_time` or until a lock on `m` is acquired. | `true` if the lock was acquired, `false` otherwise. |
| `m.try_lock_shared_until(abs_time)` | Blocks until the provided time point `abs_time` is reached or a lock on `m` is acquired. | `true` if the lock was acquired, `false` otherwise. |

### Notes

The `try_lock_shared_for` and `try_lock_shared_until` member functions obtain a shared lock on `m` on success.

### Standard library

The following standard library types satisfy *SharedTimedLockable* requirements:

- `shared_timed_mutex` (C++14): provides shared mutual exclusion facility and implements locking with a timeout (class)

### See also

- [Thread support library](https://en.cppreference.com/w/cpp/thread)
- [*SharedTimedMutex*](https://en.cppreference.com/w/cpp/named_req/SharedTimedMutex)
- [*SharedLockable*](https://en.cppreference.com/w/cpp/named_req/SharedLockable)

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