std::mutex (3) - Linux Man Pages
Defined in header <mutex>
class mutex; (since C++11)
The mutex class is a synchronization primitive that can be used to protect shared data from being simultaneously accessed by multiple threads.
mutex offers exclusive, non-recursive ownership semantics:
* A calling thread owns a mutex from the time that it successfully calls either lock or try_lock until it calls unlock.
* When a thread owns a mutex, all other threads will block (for calls to lock) or receive a false return value (for try_lock) if they attempt to claim ownership of the mutex.
* A calling thread must not own the mutex prior to calling lock or try_lock.
The behavior of a program is undefined if a mutex is destroyed while still owned by any threads, or a thread terminates while owning a mutex. The mutex class satisfies all requirements of Mutex and StandardLayoutType.
std::mutex is neither copyable nor movable.
Member type Definition
constructor (public member function)
destructor (public member function)
operator= not copy-assignable
lock (public member function)
try_lock (public member function)
unlock (public member function)
native_handle (public member function)
std::mutex is usually not accessed directly: std::unique_lock, std::lock_guard,
(since C++17) manage locking in a more exception-safe manner.
This example shows how a mutex can be used to protect a std::map shared between two threads.
// Run this code