Boost.Thread for C++: Complete Guide with Examples

\n\n

1. What It Is and Why It's Needed

\n

\nBoost.Thread is a powerful and mature library from the Boost C++ Libraries collection, providing portable (cross-platform) tools for working with multithreading. It appeared long before the C++11 standard introduced its own <thread> module, and remains in demand due to its flexibility, rich set of tools, and support for legacy compilers. The library allows you to create and manage threads, synchronize access to shared data, use locks, condition variables, barriers, semaphores, thread pools, and much more.\n

\n

\nWhy use Boost.Thread if the standard library exists? First, Boost.Thread provides additional primitives not found in the C++ standard (e.g., barrier, future with when_any support, thread_group). Second, it has a richer API for thread management (e.g., the ability to set thread stack size, priority, name). Third, Boost.Thread guarantees code portability across different platforms (Windows, Linux, macOS) and compilers (MSVC, GCC, Clang), which is critical for large projects. Finally, Boost.Thread is actively used in legacy projects where migration to C++11/17/20 is difficult.\n

\n

\nOn the educational website PythonLib, we consider Boost.Thread as an excellent example of what an "industrial" multithreading library in C++ looks like. It teaches proper handling of shared resources, helps avoid deadlocks and race conditions, and demonstrates design patterns for multithreaded applications.\n

\n\n

2. Installation

\n

\nBoost.Thread is not installed via pip, npm, or cargo — it is a C++ library that is installed together with Boost. Below are the exact commands for different systems.\n

\n\n

Linux (Ubuntu/Debian)

\n

sudo apt-get update\nsudo apt-get install libboost-all-dev

\n\n

macOS (Homebrew)

\n

brew install boost

\n\n

Windows (vcpkg)

\n

vcpkg install boost-thread

\n\n

Windows (manual build)

\n

Download Boost from the official website, unpack it, and run:

\n

bootstrap.bat\n.\\b2 --with-thread

\n\n

Building with CMake (example)

\n

In your CMakeLists.txt:

\n

find_package(Boost REQUIRED COMPONENTS thread)\ntarget_link_libraries(your_target PRIVATE Boost::thread)

\n\n

3. Quick Start — Minimal Working Example

\n

Create a file main.cpp:

\n

#include <iostream>\n#include <boost/thread.hpp>\n\nvoid hello() {\n    std::cout << "Hello from thread! Thread ID: "\n              << boost::this_thread::get_id() << std::endl;\n}\n\nint main() {\n    boost::thread t(hello);\n    t.join(); // Wait for the thread to finish\n    std::cout << "Main thread finished." << std::endl;\n    return 0;\n}

\n

Compile and run:

\n

g++ main.cpp -lboost_thread -lboost_chrono -pthread -o main\n./main

\n

Output (thread ID will be different):

\n

Hello from thread! Thread ID: 0x7f8b9c0b9700\nMain thread finished.

\n\n

4. Main Methods/Functions/Classes

\n\n

4.1. boost::thread — Creating and Managing Threads

\n

Signature:

\n

explicit thread(const boost::function0<void>& thread_function);\nvoid join();\nvoid detach();\nbool joinable() const;

\n

What it does: The boost::thread class represents a