◐ Shell
clean mode source ↗

std::recursive_mutex::lock - cppreference.com

De cppreference.com

void lock();

(desde C++11)

Bloquea el mutex. Si otro hilo ya bloqueó el mutex, una llamada a lock bloqueará la ejecución hasta que se adquiera el cerrojo.

Un hilo puede llamar a lock en un mutex recursivo repetidamente. La propiedad solo se liberará después que el hilo haga el mismo número de llamadas a unlock.

No se especifica el número máximo de niveles de propiedad. Se lanzará una excepción de tipo std::system_error si se excede este número.

Las operaciones unlock() anteriores en el mismo mutex se sincronizan-con esta operación (como se define en std::memory_order).

Parámetros

(Ninguno)

Valor de retorno

(Ninguno)

Excepciones

Lanza std::system_error cuando ocurren errores, incluyendo errores del sistema operativo subyacente que previenen a lock cumplir con sus especificaciones. El mutex no está bloqueado en caso que se lance cualquier excepción.

Notas

lock() habitualmente no se llama directamente: std::unique_lock, std::scoped_lock, y std::lock_guard se usan para gestionar bloqueo exclusivo.

Ejemplo

Este ejemplo muestra cómo lock y unlock pueden usarse para proteger datos compartidos.

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

int g_num = 0;  // protegida por 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;
        std::cout << id << " => " << g_num << '\n';
        g_num_mutex.unlock();

        std::this_thread::sleep_for(std::chrono::seconds(1));
    }
}

int main()
{
    std::thread t1(slow_increment, 0);
    std::thread t2(slow_increment, 1);
    t1.join();
    t2.join();
}

Posible salida:

0 => 1
1 => 2
0 => 3
1 => 4
0 => 5
1 => 6

Véase también