A simple, fast and functional thread pool implementation using pure C++20.
Featuresdp::thread-pool is a header only library. All the files needed are in include/thread_pool.
ThreadPool defines two CMake targets:
ThreadPool::ThreadPooldp::thread-poolYou can then use find_package():
find_package(dp::thread-pool REQUIRED)
Alternatively, you can use something like CPM which is based on CMake's Fetch_Content module.
CPMAddPackage(
NAME thread-pool
GITHUB_REPOSITORY DeveloperPaul123/thread-pool
GIT_TAG 0.6.0 # change this to latest commit or release tag
OPTIONS
"TP_BUILD_TESTS OFF"
"TP_BUILD_BENCHMARKS OFF"
"TP_BUILD_EXAMPLES OFF"
)
UsageEnqueue tasks without a returned result:
pool.enqueue_detach([](int value) { }, 34);
pool.enqueue_detach([](int value) { }, 37);
pool.enqueue_detach([](int value) { }, 38);
Definition thread_pool.h:35
Enqueue tasks with a returned value:
auto result = pool.enqueue([](int value) -> int { return value; }, 34);
auto value = result.get();
You can see other examples in the /examples folder.
Benchmarks were run using the nanobench library. See the ./benchmark folder for the benchmark code. The benchmarks are set up to compare matrix multiplication using the dp::thread_pool versus other thread pool libraries. These include:
The benchmarks are set up so that each library is tested against dp::thread_pool using std::function as the baseline. Relative measurements (in %) are recorded to compare the performance of each library to the baseline.
In general, dp::thread_pool is faster than other thread pool libraries in most cases. This is especially the case when std::move_only_function is available. fu2::unique_function is a close second, and std::function is the sloweset when used in dp::thread_pool. In certain situations, riften::ThreadPool pulls ahead in performance. This is likely due to the fact that this library uses a lock-free queue. There is also a custom semaphore and it seems that there is a difference in how work stealing is handled as well. Interestingly, task_thread_pool seems to pull ahead with large numbers of smaller tasks.
Below is a portion of the benchmark data from the MSVC results:
relative ms/op op/s err% total matrix multiplication 256x256 100.0% 93.27 10.72 0.7% 16.69dp::thread_pool - std::function 102.9% 90.66 11.03 0.6% 16.22 dp::thread_pool - std::move_only_function 98.7% 94.50 10.58 0.2% 16.91 dp::thread_pool - fu2::unique_function 93.5% 99.73 10.03 0.4% 17.86 BS::thread_pool 102.2% 91.29 10.95 0.6% 16.39 task_thread_pool 100.1% 93.18 10.73 1.4% 16.61 riften::Thiefpool
If you wish to look at the full results, use the links below.
MSVC Results
Clang Results
Some notes on the benchmark methodology:
(MxM) * (MxM) where * refers to a matrix multiplication operation.This project has been built with:
10.+ (via WSL on Windows)11.+ (vis WSL on Windows)3.19+To build, run:
cmake -S . -B build
cmake --build build
Build Options Option Description DefaultTP_BUILD_TESTS Turn on to build unit tests. Required for formatting build targets. ON TP_BUILD_EXAMPLES Turn on to build examples ON Run clang-format
Use the following commands from the project's root directory to check and fix C++ and CMake source style. This requires clang-format, cmake-format and pyyaml to be installed on the current system. To use this feature you must turn on TP_BUILD_TESTS.
# view changes
cmake --build build/test --target format
# apply changes
cmake --build build/test --target fix-format
See Format.cmake for details.
Build the documentationThe documentation is automatically built and published whenever a GitHub Release is created. To manually build documentation, call the following command.
cmake -S documentation -B build/doc
cmake --build build/doc --target GenerateDocs
# view the docs
open build/doc/doxygen/html/index.html
To build the documentation locally, you will need Doxygen and Graphviz on your system.
ContributingContributions are very welcome. Please see contribution guidelines for more info.
LicenseThe project is licensed under the MIT license. See [LICENSE](LICENSE) for more details.
Author| <img src="https://avatars0.githubusercontent.com/u/6591180?s=460&v=4" width="100">
@DeveloperPaul123 | |:-—:|
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4