std::shared_timed_mutex:: lock
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Exclusive locking | ||||
|
shared_timed_mutex::lock
|
||||
| Shared locking | ||||
|
void
lock
(
)
;
|
(C++14 起) | |
锁定互斥锁。若其他线程已锁定该互斥锁,调用
lock
将阻塞执行直至获得锁。
如果已以任何模式(共享或独占)拥有
mutex
的线程调用
lock
,则行为未定义。
同一互斥量上的先前 unlock() 操作与此操作形成 同步关系 (定义参见 std::memory_order )。
目录 |
异常
当发生错误时抛出
std::system_error
,包括来自底层操作系统的错误,这些错误会阻止
lock
满足其规范。在任何异常被抛出的情况下,互斥锁不会被锁定。
注释
lock()
通常不直接调用:使用
std::unique_lock
、
std::scoped_lock
和
std::lock_guard
来管理独占锁定。
共享互斥锁不支持从共享所有权模式直接转换为独占所有权模式:必须先通过
unlock_shared()
释放共享锁,才能通过
lock()
获得独占所有权。为此可使用
boost::upgrade_mutex
实现该功能。
示例
此示例展示了如何使用
lock
和
unlock
来保护共享数据。
#include <chrono> #include <iostream> #include <mutex> #include <thread> int g_num = 0; // protected by g_num_mutex std::mutex g_num_mutex; void slow_increment(int id) { for (int i = 0; i < 3; ++i) { g_num_mutex.lock(); ++g_num; // note, that the mutex also syncronizes the output std::cout << "id: " << id << ", g_num: " << g_num << '\n'; g_num_mutex.unlock(); std::this_thread::sleep_for(std::chrono::milliseconds(234)); } } int main() { std::thread t1{slow_increment, 0}; std::thread t2{slow_increment, 1}; t1.join(); t2.join(); }
可能的输出:
id: 0, g_num: 1 id: 1, g_num: 2 id: 1, g_num: 3 id: 0, g_num: 4 id: 0, g_num: 5 id: 1, g_num: 6
参见
|
尝试锁定互斥锁,若互斥锁不可用则立即返回
(公开成员函数) |
|
|
解锁互斥锁
(公开成员函数) |
|
|
C 文档
关于
mtx_lock
|
|