cpp_features

为C++11扩展一些很cool的特性

coroutine -协程库、并行编程库

coroutine是一个使用C++11编写的调度式stackful协程库,

同时也是一个强大的并行编程库, 是专为Linux服务端程序开发设计的底层框架。

目前支持两个平台:

Linux   (GCC4.8+)

Win7-64bit (VS2013/2015)

使用coroutine编写并行程序，即可以像golang、erlang这些并发语言一样开发迅速且逻辑简洁，又有C++原生的性能优势，鱼和熊掌从此可以兼得。

coroutine有以下特点：

1.提供golang一般功能强大协程，基于corontine编写代码，可以以同步的方式编写简单的代码，同时获得异步的性能，
2.支持海量协程, 创建100万个协程只需使用1GB内存
3.允许用户自由控制协程调度点，随意变更调度线程数；
4.支持多线程调度协程，极易编写并行代码，高效的并行调度算法，可以有效利用多个CPU核心
5.可以让链接进程序的同步的第三方库变为异步调用，大大提升其性能。再也不用担心某些DB官方不提供异步driver了，比如hiredis、mysqlclient这种客户端驱动可以直接使用，并且可以得到不输于异步driver的性能。
6.动态链接和静态链接全都支持，便于使用C++11的用户静态链接生成可执行文件并部署至低版本的linux系统上。
7.提供协程锁(co_mutex), 定时器, channel等特性, 帮助用户更加容易地编写程序.
8.网络性能强劲，超越ASIO异步模型；尤其在处理小包和多线程并行方面非常强大。
如果你发现了任何bug、有好的建议、或使用上有不明之处，可以提交到issue，也可以直接联系作者: email: 289633152@qq.com QQ交流群: 296561497
coroutine/samples目录下有很多示例代码，内含详细的使用说明，让用户可以循序渐进的学习coroutine库的使用方法。

网络库：

基于coroutine编写的网络库，在network目录中，支持udp/tcp协议

RPC框架：

基于coroutine和network编写的高性能通用RPC框架Ucorf，开源地址:https://github.com/yyzybb537/ucorf

coroutine的编译与使用:

Linux:

0.如果你安装了ucorf，那么你已经安装过coroutine了，可以跳过第1步.

1.使用CMake进行编译安装：
```
  $ mkdir build
  $ cd build
  $ cmake .. -DCMAKE_BUILD_TYPE=RELEASE
  $ sudo make install

如果希望编译可调试的版本, 只需要cmake那行命令变为:

  $ cmake ..
```
2.以动态链接的方式使用时，一定要最先链接libcoroutine.so，还需要链接libdl.so. 例如：
```
  g++ -std=c++11 test.cpp -lcoroutine -ldl [-lother_libs]
```
3.以静态链接的方式使用时，只需链接libcoroutine.a即可，不要求第一个被链接，但要求libc.a最后被链接. 例如:
```
  g++ -std=c++11 test.cpp -lcoroutine -static -static-libgcc -static-libstdc++
```
Windows:

1.使用git submodule update --init下载子模块

2.进入coroutine/win_patch/VS2015目录, 打开coroutine.sln，不必编译整个解决方案，只需编译coroutine工程即可。
```
其中的测试工程是依赖boost-x64的，如果要编译请先编译64bit的boost库:

  编译参数：bjam.exe address-model=64 --build-type=compelete
  
至少编译system和thread两个库，然后调整工程设置中的引用boost的路径。
```
3.编译coroutine项目（默认的工程配置暂时只配置了x64-Debug-mt版，需要其他版本请自行修改工程配置）

4.使用时需要添加两个include目录：coroutine和coroutine/win_patch

注意事项(WARNING)：

 * 1.在多线程模式下不要使用<线程局部变量>。使用多线程调度时，协程的每次切换，下一次继续执行都可能处于其他线程中
 * 2.不要让一个代码段耗时过长。协程的调度是协作式调度，需要协程主动让出执行权，推荐在耗时很长的循环中插入一些yield
 * 3.除网络IO、sleep以外的阻塞系统调用，会真正阻塞调度线程的运行，请使用co_await, 并启动几个线程去Run内置的线程池.
 * 4.协程栈上对象不可被协程外部访问。由于采用共享栈的方式调度协程，协程处于非执行状态时，
 栈上对象会被保存到另外一块内存中，因此会失效，此时通过保存的地址访问栈上对象是一种未定义行为。
 有共享需求的对象请将其置于堆上或使用channel。

multiret - 让C++支持多返回值

// demo
#include <iostream>
#include <vector>
#include <list>
#include <tuple>
#include "multi_ret.h"
using namespace std;

std::vector<int> foo() {
    return {1, 2, 3};
}

std::list<double> foo2() {
    return {9, 8, 7.0};
}

std::tuple<int, double, short> foo3() {
    return std::tuple<int, double, short>{4, 5.0, 6};
}

std::pair<int, double> foo4() {
    return std::pair<int, double>{0, 0};
}

int main()
{
    int a = 0, b = 0;
    double c = 0;
    MR(a, b, c) = foo();
    cout << a << b << c << endl;

    MR(a, b, c) = foo2();
    cout << a << b << c << endl;

    MR(a, b, c) = foo3();
    cout << a << b << c << endl;

    MR(a, b) = foo4();
    cout << a << b << endl;

    return 0;
}

tryup / cpp_features

cpp_features

coroutine -协程库、并行编程库

网络库：

RPC框架：

coroutine的编译与使用:

注意事项(WARNING)：

multiret - 让C++支持多返回值

About

Languages