Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::condition_variable: esperar pela mudança de estado partilhado

std::condition_variable bloqueia uma thread libertando atomicamente um mutex e acorda-a após notificação, mas a condição deve ser sempre verificada de novo.

Versão: C++23

Sintaxe

class condition_variable {
public:
    void notify_one() noexcept;
    void notify_all() noexcept;
    void wait(std::unique_lock<std::mutex>& lock);
    template<class Predicate>
    void wait(std::unique_lock<std::mutex>& lock, Predicate pred);
};

std::condition_variable, de <condition_variable>, coordena threads com std::unique_lock<std::mutex>. wait liberta atomicamente o mutex e bloqueia, readquirindo o lock antes de devolver. notify_one acorda uma thread em espera e notify_all acorda todas.

Uma notificação não guarda estado e pode perder-se se ninguém estiver ainda à espera. Altera estados como ready sob o mesmo mutex e espera com wait(lock, pred), que repete o teste após despertares espúrios. Podes notificar depois de desbloquear para reduzir contenção.

O unique_lock fornecido tem de possuir o lock e todas as threads que esperam no mesmo objeto têm de usar o mesmo mutex; a violação causa comportamento indefinido. Uma espera temporizada pode terminar depois do prazo. Destrói o objeto quando nenhuma thread continuar bloqueada nele; uma thread desbloqueada pode ainda estar à espera de readquirir o mutex. Fazer join de todas as threads, como no exemplo, é um padrão seguro de duração de vida, não o requisito literal da norma.

Exemplos

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

int main() {
    std::mutex mutex;
    std::condition_variable ready_changed;
    bool ready = false;
    int value = 0;

    std::jthread worker([&] {
        std::unique_lock lock(mutex);
        ready_changed.wait(lock, [&] { return ready; });
        value *= 2;
    });

    {
        std::lock_guard lock(mutex);
        value = 21;
        ready = true;
    }
    ready_changed.notify_one();
    worker.join();
    std::cout << value << '\n';
}

Resultado

42

std::condition_variable → 42

Fontes