Using Condition Variables

suggest change

A condition variable is a primitive used in conjunction with a mutex to orchestrate communication between threads. While it is neither the exclusive or most efficient way to accomplish this, it can be among the simplest to those familiar with the pattern.

One waits on a std::condition_variable with a std::unique_lock<std::mutex>. This allows the code to safely examine shared state before deciding whether or not to proceed with acquisition.

Below is a producer-consumer sketch that uses std::thread, std::condition_variable, std::mutex, and a few others to make things interesting.

#include <condition_variable>
#include <cstddef>
#include <iostream>
#include <mutex>
#include <queue>
#include <random>
#include <thread>

int main()
    std::condition_variable cond;
    std::mutex mtx;
    std::queue<int> intq;
    bool stopped = false;
std::thread producer{[&]()
    // Prepare a random number generator.
    // Our producer will simply push random numbers to intq.
    std::default_random_engine gen{};
    std::uniform_int_distribution<int> dist{};

    std::size_t count = 4006;    
        // Always lock before changing
        // state guarded by a mutex and
        // condition_variable (a.k.a. "condvar").
        std::lock_guard<std::mutex> L{mtx};

        // Push a random int into the queue

        // Tell the consumer it has an int

    // All done.
    // Acquire the lock, set the stopped flag,
    // then inform the consumer.
    std::lock_guard<std::mutex> L{mtx};

    std::cout << "Producer is done!" << std::endl;

    stopped = true;

std::thread consumer{[&]()
        std::unique_lock<std::mutex> L{mtx};
            // Acquire the lock only if
            // we've stopped or the queue
            // isn't empty
            return stopped || ! intq.empty();

        // We own the mutex here; pop the queue
        // until it empties out.

        while( ! intq.empty())
            const auto val = intq.front();

            std::cout << "Consumer popped: " << val << std::endl;

            // producer has signaled a stop
            std::cout << "Consumer is done!" << std::endl;



std::cout << "Example Completed!" << std::endl;

return 0;

Feedback about page:

Optional: your email if you want me to get back to you:

Table Of Contents