# std::recursive_timed_mutex

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

The recursive_timed_mutex class is a synchronization primitive that can be used to protect shared data from being simultaneously accessed by multiple threads.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <mutex>
class recursive_timed_mutex; // (since C++11)
```

The `recursive_timed_mutex` class is a synchronization primitive that can be used to protect shared data from being simultaneously accessed by multiple threads.

In a manner similar to `std::recursive_mutex`, `recursive_timed_mutex` provides exclusive, recursive ownership semantics. In addition, `recursive_timed_mutex` provides the ability to attempt to claim ownership of a `recursive_timed_mutex` with a timeout via the `try_lock_for` and `try_lock_until` member functions.

The `recursive_timed_mutex` class satisfies all requirements of *TimedMutex* and *StandardLayoutType*.

### Member types

**Member type — Definition**

- `native_handle_type` (optional*): implementation-defined

### Member functions

- (constructor): constructs the mutex (public member function)
- (destructor): destroys the mutex (public member function)
- `operator=` [deleted]: not copy-assignable (public member function)

**Locking**

- `lock`: locks the mutex, blocks if the mutex is not available (public member function)
- `try_lock`: tries to lock the mutex, returns if the mutex is not available (public member function)
- `try_lock_for`: tries to lock the mutex, returns if the mutex has been unavailable for the specified timeout duration (public member function)
- `try_lock_until`: tries to lock the mutex, returns if the mutex has been unavailable until specified time point has been reached (public member function)
- `unlock`: unlocks the mutex (public member function)

**Native handle**

- `native_handle`: returns the underlying implementation-defined native handle object (public member function)

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