Defined in header <mutex> | ||
---|---|---|
class recursive_mutex; | (since C++11) |
The recursive_mutex
class is a synchronization primitive that can be used to protect shared data from being simultaneously accessed by multiple threads.
recursive_mutex
offers exclusive, recursive ownership semantics:
- A calling thread owns a
recursive_mutex
for a period of time that starts when it successfully calls eitherlock
ortry_lock
. During this period, the thread may make additional calls tolock
ortry_lock
. The period of ownership ends when the thread makes a matching number of calls tounlock
. - When a thread owns a
recursive_mutex
, all other threads will block (for calls tolock
) or receive afalse
return value (fortry_lock
) if they attempt to claim ownership of therecursive_mutex
. - The maximum number of times that a
recursive_mutex
may be locked is unspecified, but after that number is reached, calls tolock
will throwstd::system_error
and calls totry_lock
will returnfalse
.
The behavior of a program is undefined if a recursive_mutex
is destroyed while still owned by some thread. The recursive_mutex
class satisfies all requirements of Mutex
and StandardLayoutType
.
Member types
Member type | Definition |
---|---|
native_handle_type | implementation-defined |
Member functions
constructs the mutex (public member function) | |
(destructor)
| destroys the mutex (public member function) |
operator= [deleted] | not copy-assignable (public member function) |
Locking | |
locks the mutex, blocks if the mutex is not available (public member function) | |
tries to lock the mutex, returns if the mutex is not available (public member function) | |
unlocks the mutex (public member function) | |
Native handle | |
returns the underlying implementation-defined thread handle (public member function) |
Please login to continue.