Spec-Zone.ru › C++

std::shared_timed_mutex::lock

void lock();
(since C++14)

Блокирует мьютекс. Если другой поток уже заблокировал мьютекс, вызов lock заблокирует выполнение, пока блокировка не будет получена.

Если lock вызывается потоком, который уже владеет mutex в любом режиме (совместном или эксклюзивном), поведение не определено.

Предыдущие 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

См. также

try_lock
пытается заблокировать мьютекс, возвращает, если мьютекс недоступен
(публичный член-функция)
unlock
разблокирует мьютекс
(публичный член-функция)
C документация для mtx_lock

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/thread/shared_timed_mutex/lock

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API