std::mutex (C++11)

In a Nutshell

The most basic mutex, allowing only one thread to hold it at any given time, used to protect shared data between threads.

Header

#include <mutex>

Core API Cheat Sheet

Operation	Signature	Description
Construct	mutex()	Constructs the mutex
Destruct	~mutex()	Destroys the mutex
Lock	void lock()	Locks the mutex, blocks if unavailable
Try Lock	bool try_lock()	Tries to lock, returns false immediately if unavailable
Unlock	void unlock()	Unlocks the mutex
Native Handle	native_handle_type native_handle()	Returns the implementation-defined native handle

Minimal Example

#include <iostream>
#include <mutex>
#include <thread>

int counter = 0;
std::mutex m;

void increment() {
    std::lock_guard<std::mutex> lock(m);
    ++counter;
}

int main() {
    std::thread t1(increment);
    std::thread t2(increment);
    t1.join();
    t2.join();
    std::cout << counter << '\n'; // 输出: 2
}

Embedded Suitability: High

• Usually a zero-overhead abstraction; incurs only atomic operation overhead when uncontended.
• Non-copyable and non-movable, with a deterministic memory layout.
• Recommended to use with lock_guard to prevent deadlocks caused by exception paths.
• Note: In RTOS environments, ensure that the underlying pthread or OS primitives are available.

Compiler Support

GCC	Clang	MSVC
4.4	3.3	2010

See Also

• Tutorial: Mutexes and RAII Guards
• cppreference: std::mutex

---

Some content referenced from cppreference.com, licensed under CC-BY-SA 4.0