##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# C++ concepts: SharedTimedMutex

From cppreference.com
< cpp‎ | concept

The `SharedTimedMutex` concept extends the `TimedMutex` concept to include shared lock ownership mode.

### [edit] Requirements

- `TimedMutex`
- `SharedMutex`

Additionally, for object `m` of `SharedTimedMutex` type supports timed shared operations:

- The expression m.try_lock_shared_for(duration) has the following properties

  - Behaves as an atomic operation.
  - Attempts to obtain shared ownership of the mutex within the duration specified by `duration`. If `duration` is less or equal `duration.zero()`, attempts to obtain the ownership without waiting (as if by `try_lock()`). Otherwise, this function blocks until the mutex is acquired or until the time specified by `duration` passes. It returns within `duration` only if it succeeds, but it allowed to fail to acquire the mutex even if at some point in time during `duration` it was not owned by another thread. In any case, it returns true if the mutex was acquired and false otherwise.
  - If `try_lock_shared_for(duration)` succeeds, prior `unlock()` operations on the same object synchronize-with this operation (equivalent to release-acquire std::memory_order).
  - The behavior is undefined if the calling thread already owns the mutex in any mode
  - If an exception is thrown, the shared lock is not acquired.

- The expression m.try_lock_shared_until(time_point) has the following properties

  - Behaves as an atomic operation.
  - Attempts to obtain shared ownership of the mutex within the time left until `time_point`. If `time_point` already passed, attempts to obtain the ownership without locking (as if by `try_lock()`). Otherwise, this function blocks until the mutex is acquired or until the time specified by `time_point` passes. It returns before `time_point` only if it succeeds, but it allowed to fail to acquire the mutex even if at some point in time before `time_point` it was not owned by another thread. In any case, it returns true if the mutex was acquired and false otherwise.
  - If `try_lock_shared_until(time_point)` succeeds, prior `unlock()` operations on the same object synchronize-with this operation (equivalent to release-acquire std::memory_order).
  - The behavior is undefined if the calling thread already owns the mutex in any mode
  - If an exception is thrown, the shared lock is not acquired.

### [edit] Library types

The following standard library types satisfy `SharedTimedMutex`:

- std::shared_timed_mutex

### [edit] See also

- Thread support library
- `Mutex`
- `TimedMutex`
- `SharedMutex`

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/concept/SharedTimedMutex&oldid=79528"