(原创)发布一个c++11开发的轻量级的并行Task库TaskCpp

TaskCpp简介

　　TaskCpp是c++11开发的一个跨平台的并行task库，它的设计思路来源于微软的并行计算库ppl和intel的并行计算库tbb，关于ppl和tbb我在前面有介绍。既然已经有了这两个大公司开发的并行计算库，我为什么还要开发自己的并行计算库。有两个原因：

ppl只能在windows上用不能跨平台，tbb能跨平台，但是受限于原始设计，tbb的task比较弱没有ppl的强大，所以他们不能完全满足我的要求；
我觉得可以用c++11可以开发出一个轻量级的好用的并行task库。

　　TaskCpp在接口设计上尽量和ppl保持一致，因为我觉得ppl的接口很好很强大。因此，TaskCpp的接口用法和语义和ppl基本是一致的。因为TaskCpp是一个轻量级的task库，总共也不过三百多行代码，本着简单够用的原则，只提供了一些和ppl类似的常用用法, 有些不常用的特性不考虑支持。比如，不支持任务的取消，因为加入任务的取消会导致增加很多复杂性，而实际中用得比较少，所以不考虑支持，够用就好。

支持的平台

需要支持c++11的编译器，建议编译器：

linux: GCC4.7+
windows: vs2012 nov ctp+, 最好是vs2013

库的使用

　　使用TaskCpp仅仅需要包含头文件即可，在程序中使用只需要包含#include <TaskCpp.h>和少量的boost头文件即可。

TaskCpp的功能

TaskCpp提供一下功能：

并行任务：一种并行执行若干工作任务的机制。
- 基本的异步任务
- 延续的任务
- 组合任务
  - WhenAll
  - WhenAny
- 任务组
并行算法：并行作用于数据集合的泛型算法。
- ParallelForeach算法
- ParallelInvoke算法
- ParallelReduce算法

TaskCpp用法介绍

并行任务

基本的异步任务Task

　　Task会创建一个异步操作，这个异步操作发起方式是延迟加载方式发起的，即在调用Task的Wait或者Get时才真正发起异步操作。Task可以通过std::function或者lambda表达式去创建，不支持直接原生函数创建，如果要用原生函数需要先通过lambda或者std::function包装一下。Task的Wait接口只是等待异步操作结束。Task的Get接口接收参数并等待异步操作结束并返回结果。PPL中的get接口是不能接收参数的，TaskCpp的Get接口是可以接受任意参数的，更灵活一点，算是较PPL的一个小优点吧。下面是Task的基本用法：

#include <TaskCpp.h>

using namespace Cosmos;

void TestTask()

{

    Task<void()> task([]{cout <<  << endl; });

    task.Wait();

    Task<void()> task1 = []{cout <<  << endl; };

    task1.Wait();

    Task<int()> task2 = []{cout <<  << endl; return ; };

    cout << task2.Get() << endl;

    Task<int(int)> task3 = [](int i){cout << i << endl; return i; };

    cout << task3.Get() << endl;

}

组合任务--WhenAll

　　WhenAll保证一个任务集合中所有的任务完成。WhenAll函数会生成一个任务，该任务可在完成一组任务之后完成。此函数可返回一个std::vector 对象，该对象包含集合中每个任务的结果。以下基本示例使用WhenAll创建表示完成其他三个任务的任务。下面是WhenAll的基本用法：

void PrintThread()

{

    cout << std::this_thread::get_id() << endl;

    std::this_thread::sleep_for(std::chrono::milliseconds());

}

void TestWhenAll()

{

    vector<Task<int()>> v = {

        Task<int()>([]{PrintThread(); std::this_thread::sleep_for(std::chrono::seconds()); return ; }),

        Task<int()>([]{PrintThread(); return ; }),

        Task<int()>([]{PrintThread(); return ; }),

        Task<int()>([]{PrintThread(); return ; })

    };

    cout << "when all " << endl;

    WhenAll(v).Get();

}

　　注意：WhenAll是非阻塞的，它只是创建一个任务，在Wait或Get时才发起异步操作。传递给WhenAll的任务必须是统一的。换言之，它们必须都返回相同类型。

组合任务--WhenAny

　　WhenAny在任务集合中任意一个任务结束之后就返回。函数会生成一个任务，该任务可在完成一组任务的第一个任务之后完成。此函数可返回一个 std::pair 对象，该对象包含已完成任务的结果和集合中任务的索引。下面是WhenAny的基本用法：

void TestWhenAny()

{

    vector<Task<int()>> v = {

        Task<int()>([]{PrintThread(); std::this_thread::sleep_for(std::chrono::seconds()); return ; }),

        Task<int()>([]{PrintThread(); return ; }),

        Task<int()>([]{PrintThread(); return ; }),

        Task<int()>([]{PrintThread(); return ; })

    };

    cout << "when any " << endl;

    WhenAny(v).Then([](std::pair<int, int>& result)

    {

        cout << " index " << result.first << " result " << result.second << endl;

        return result.second;

    }).Then([](int result){cout << "any result: " << result << endl; }).Get();

}

　　注意：WhenAny是非阻塞的，它只是创建一个任务，在Wait或Get时才发起异步操作。传递给WhenAny的任务必须是统一的。换言之，它们必须都返回相同类型。

任务组--TaskGroup

　　TaskGroup可以并行的处理一组任务，TaskGroup可以接受多个task或者function，TaskGroup的Wait等待所有任务完成。下面是TaskGroup的基本用法：

void TestTaskGroup()

{

    Task<int()> t1([]{PrintThread(); return ; });

    Task<double()> t2([]{PrintThread(); return 2.123; });

    Task<void()> t3([]{PrintThread(); });

    Task<string()> t4([]{PrintThread(); return "ok"; });

    TaskGroup group;

    group.Run(t1);

    group.Run(t2);

    group.Run(t3);

    group.Run(t4); 

    //如果你觉得这样一个一个Run加入任务，你也可以一起Run

    group.Run(t1, t2, t3, []{PrintThread(); return ; });

    group.Wait();

}

　　PPL的task_group的任务只能是void()形式的，TaskCpp允许一些简单类型的任务如int()、double()、string()等，其实任务的返回类型没有实际意义，因为Wait没有返回值，这里支持多种返回类型的任务只不过是为了减少一点限制，用起来稍微方便一点罢了。PPL加入任务只能一个一个Run，要加入多个任务时有点繁琐，TaskCpp可以一次Run多个任务，比PPL要方便一些。这两点算是较PPL的两个小优点吧。

并行算法

ParallelForeach算法

　　ParallelForeach算法与 STL std::for_each 算法类似，只是 parallel_for_each 算法并发执行任务。用法比较简单：

bool check_prime(int x) // 为了体现效果, 该函数故意没有优化.

{

    for (int i = ; i < x; ++i)

    if (x % i == )

        return false;

    return true;

}

void TestParallelFor()

{

    vector<int> v;

    for (int i = ; i < ; i++)

    {

        v.push_back(i + );

    }

    boost::timer t;

    ParallelForeach(v.begin(), v.end(), check_prime);

    ParallelForeach(v.begin(), v.end(), check_prime);

    cout << "taskcpp: " << t.elapsed() << endl;

}

ParallelInvoke算法

　　ParallelInvoke算法并行执行一组任务。在完成所有任务之前，此算法不会返回。当您需要同时执行多个独立的任务时，此算法很有用。ParallelInvoke和TaskGroup的作用是一样的。用法比较简单：

void TestParaInvoke()

{

    auto f = []{cout << "" << endl; return ; };

    ParallelInvoke(f, []{cout << "" << endl; });

}

ParallelReduce算法

　　ParallelReduce算法在实际应用中比较常用，有点类似于map-reduce，可以并行的对一个集合进行reduce操作。ParallelReduce的用法稍微复杂一点，它的原型：

- ParallelReduce(range,init, reduceFunc);
- ParallelReduce(range,init, rangeFunc, reduceFunc);

　　第一个参数是集合，第二个参数是算法的初始值，第三个参数rangeFunc是一个声称中间结果的函数，第四个参数是中间结果的汇聚函数。如果调用ParallelReduce(range,init, reduceFunc)，则表示rangeFunc和reduceFunc是一个函数。

　　下面的例子是并行的计算100000000个整数的和：

void TestParallelSum()

{

    vector<int> v;

    const int Size = ;

    v.reserve(Size);

    for (int i = ; i < Size; i++)

    {

        v.push_back(i + );

    }

    int i = ;

    boost::timer t;

    auto r = ParallelReduce(v, i, [](const vector<int>::iterator& begin, 

vector<int>::iterator&end, int val)

    {

        return std::accumulate(begin, end, val);

    });

    cout << t.elapsed() << " " << r << endl;

}

　　下面是并行查找最长的字符串的例子：

void TestFindString()

{

    vector<string> v;

    v.reserve();

    for (int i = ; i < ; i++)

    {

        v.emplace_back(std::to_string(i + ));

    }

    string init = "";

    auto f = [](const vector<string>::iterator& begin, vector<string>::iterator&end, string& val)

    {

        return *std::max_element(begin, end, [](string& str1, string& str2){return str1.length()<str2.length(); });

    };

    boost::timer t;

    auto r = ParallelReduce(v, init, f, f);

    cout << t.elapsed() << " " << r << endl;

}

性能

　　用四个测试用例对比测试了tbb、ppl、TaskCpp和单线程的性能。下图是测试对比的结果：

　　可以看到TaskCpp的性能比单线程效率要高，总体上也优于ppl和tbb，其中ppl和tbb在某些场景下性能还不如单线程高，所以在使用时要以实际测试数据为准，并不是一用并行库效率就能提高。

下载地址

TaskCpp 更新版本TaskCppV1.1

TaskCpp开源协议

　　遵循LGPL（GNU General Public License）协议。

注意

TaskCpp是一个任务库，不是线程池，每启动一个task就会创建一个线程，如果需要线程池可以看这里。

联系我

　　如果发现问题或者有什么建议请给我留言或者发邮件qicosmos@163.com .

　　c++11 boost技术交流群：296561497，欢迎大家来交流技术。

后记

　　TaskCpp的开发和测试花费了我两三周的时间，开发之初我就计划将其开源，我希望更多的人能用起来并推广TaskCpp，促进它的发展。曾经有人问我，为什么坚持发原创文章分享技术，是不是有什么好处。我一下子还真答不上来，因为我根本就没有想过有啥好处，现在再想一下，好处嘛，分享的术也许对别人学习有帮助吧。再想想我这样做的原因，一个原因是兴趣，这要感谢c++11，是c++11让我觉得c++语言是非常有意思和有魅力的语言，总能带给人惊喜，没有c++11我也不可能完成TaskCpp库。还有就是一点点分享快乐的精神，我分享我快乐。最重要的原因是一点点梦想，c++中开源库太少了，很多框架和基础库都还不够，远远赶不上java，所以在使用和推广上不如java。但是我有一点梦想：我希望通过自己的一点努力能让c++的世界变得更加美好，能让c++开发者的日子变得美好。是的，正是这个梦想促使我将我开发的大部分代码都开源出来！也正是这个梦想促使我坚持写原创博客分享技术！