Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 21 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,52 +8,53 @@ A thread pool is a programming pattern for parallel execution of jobs, http://en

More specifically, there are some threads dedicated to the pool and a container of jobs. The jobs come to the pool dynamically. A job is fetched and deleted from the container when there is an idle thread. The job is then run on that thread.

A thread pool is helpful when you want to minimize time of loading and destroying threads and when you want to limit the number of parallel jobs that run simultanuasly. For example, time consuming event handlers may be processed in a thread pool to make UI more responsive.
A thread pool is helpful when you want to minimize time of loading and destroying threads and when you want to limit the number of parallel jobs that run simultaneously. For example, time consuming event handlers may be processed in a thread pool to make UI more responsive.

Features:
- standard c++ language, tested to compile on MS Visual Studio 2013 (2012?), gcc 4.8.2 and mingw 4.8.1(with posix threads)
- simple but effiecient solution, one header only, no need to compile a binary library
- simple but efficient solution, one header only, no need to compile a binary library
- query the number of idle threads and resize the pool dynamically
- one API to push to the thread pool any collable object: lambdas, functors, functions, result of bind expression
- collable objects with variadic number of parameters plus index of the thread running the object
- one API to push to the thread pool any callable object: lambdas, functors, functions, result of bind expression
- callable objects with variadic number of parameters plus index of the thread running the object
- automatic template argument deduction
- get returned value of any type with standard c++ futures
- get fired exceptions with standard c++ futures
- use for any purpose under Apache license
- two variants, one depends on Boost Lockfree Queue library, http://boost.org, which is a header only library


Sample usage
Sample usage:

<code>void first(int id) {
```c++
void first(int id) {
std::cout << "hello from " << id << '\n';
}</code>
}

<code>&#32;&#32;struct Second {
struct Second {
void operator()(int id) const {
std::cout << "hello from " << id << '\n';
}
} second;

<code>void third(int id, const std::string & additional_param) {}</code>
void third(int id, const std::string & additional_param) {}


<code>int main () {</code>
int main () {

<code>&#32;&#32;&#32;&#32;ctpl::thread_pool p(2 /* two threads in the pool */);</code>
ctpl::thread_pool p(2); // two threads in the pool

<code>&#32;&#32;&#32;&#32;p.push(first); // function</code>
p.push(first); // function

<code>&#32;&#32;&#32;&#32;p.push(third, "additional_param");</code>
p.push(third, "additional_param");

<code>&#32;&#32;&#32;&#32;p.push( &#91;&#93; (int id){
p.push( [](int id){
std::cout << "hello from " << id << '\n';
}); // lambda</code>
}); // lambda

<code>&#32;&#32;&#32;&#32;p.push(std::ref(second)); // functor, reference</code>
p.push(std::ref(second)); // functor, reference

<code>&#32;&#32;&#32;&#32;p.push(const_cast&#60;const Second &&#62;(second)); // functor, copy ctor</code>
p.push(const_cast<const Second &>(second)); // functor, copy ctor

<code>&#32;&#32;&#32;&#32;p.push(std::move(second)); // functor, move ctor</code>

<code>}</code>
p.push(std::move(second)); // functor, move ctor
}
```