C++基础库CO 1.1发布

2020-7-13 00:10| 发布者: joejoe0332| 查看: 749| 评论: 0|原作者: oschina|来自: oschina

摘要: C++ 基础库 co 1.1 发布。CO 是一个优雅、高效的 C++ 基础库，支持 Linux, Windows 与 Mac 平台。 CO 追求极简、高效，不依赖于 boost 等三方库，仅使用了少量 C++11 特性。 github Changes 代码结构调整头文件放到 ...

C++ 基础库 co 1.1 发布。CO 是一个优雅、高效的 C++ 基础库，支持 Linux, Windows 与 Mac 平台。

CO 追求极简、高效，不依赖于 boost 等三方库，仅使用了少量 C++11 特性。

github

Changes

代码结构调整

头文件放到 include 目录.
源文件放到 src 目录.
rpcgen 更名为 gen.
移除 unitest/base 目录，单元测试代码直接放到 unitest 目录下.
test 目录下支持子目录.

fast

fast.cc 中静态变量的定义放到函数中，初始化更安全.
fast::dtoa 弃用基于 LruMap 的实现，换用 Milo Yip 的实现(miloyip/dtoa-benchmark).
新增 fast::stream 类，提供基本的流式输出操作.

fastream

继承于 fast::stream 类.
支持 move 构造函数.

增加空状态.

fastream fs; // 定义一个空的 fastream 对象，不分配内存

支持 append 自己.

fastream fs;
fs << "hello " << 23;
fs.append(fs);
fs << fs;     // <==> fs.append(fs)

fastring

与 fastream 一样，继承于 fast::stream 类，因此也支持流式输出操作.
```
fastring s;
s << "hello " << 23;
```
fastring 与 fastream 的内存结构相同，二者可以无缝转换.
```
fastring s;
fastream& fs = *(fastream*)&s
```
移除引用计数，使 fastring 的复制行为与 std::string 类似，使用起来不容易出错.
```
fastring s("hello");
fastring t(s);  // 通过内存拷贝创建一个新的字符串
```
append 操作增加 inside 检查，修复内存重叠时的逻辑漏洞.
```
fastring s("123");
s.append(s.c_str() + 1); // s -> "12323"
```
删除 clone() 方法，移除引用计数后，此方法多余.

str

str::dbg() 支持 std::unordered_map 与 std::unordered_set.

flag

优化命令行参数与配置文件的解析顺序，先解析配置文件，再解析其他命令行参数.

# 先解析配置文件 xx.conf，再解析其他命令行参数
# 命令行中 x, s 的值会覆盖 xx.conf 中的值，方便调试
./xx -x -s="hello" -config=xx.conf

Linux 平台增加内置 bool flag daemon，以支持后台运行程序

# 可在命令行参数中带上 -daemon
# 也可在配置文件中设置: daemon = true
./xx -daemon

命令行参数支持多种格式，-x=y 可以写成 -x y 或者 x=y

./xx -i=8 u=88 -s="hello world"
./xx -i 8 -u 88 -s "hello world"

优化程序启动时指定配置文件的方式.

./xx config=xx.conf  # 用 flag config 显示指定
./xx xx.conf         # 配置文件名以 .conf 或 config 结尾，且是程序命令行的第一个非 flag 参数，则可省略 config=
./xx -x xx.conf      # -x 是 flag，xx.conf 是第一个非 flag 参数

定义 flag 时，可以在注释中指定级别，以控制 flag 在配置文件中的顺序.

// 在注释开头用 #3 指定级别为 3
// 支持的级别为 0-99，默认为 10
// 使用 --mkconf 自动生成配置文件时，flag 按级别、文件名、代码行数排序
DEF_bool(b, false, "#3 xxx");

log

signal handler 中部分函数修改为 async-signal-safe 版本的函数，更安全.

协程库

修复未及时移除 epoll(kevent, iocp) 中注册的 io 事件引起的 bug.
修复 Scheduler 在 add_timer() 时，内部 iterator 未正确更新的 bug.
改进 co::connect, co::accept 等的实现，以支持 ipv6.
新增 co::max_sched_num() 接口，获取支持的最大调度线程数，目前为系统 cpu 核数.
新增 co::sched_id() 接口，获取当前的调度线程 id.
新增 coroutine_id() 接口，获取当前协程的 id.
重构 Scheduler，内部逻辑结构更清晰，同时提高代码的可读性.

修改 co::tcp_socket(), co::udp_socket() 接口的参数为 address family，弃用早期用 4 与 6 指定 ipv4 与 ipv6 的方式.

sock_t tcp_socket(int af=AF_INET); // @af: address family, AF_INET, AF_INET6, etc.
sock_t udp_socket(int af=AF_INET); // @af: address family, AF_INET, AF_INET6, etc.

新增 co::socket() 接口，与原生 api 保持一致.
修复 hook 实现中一些静态全局变量的初始化问题.
优化 co::Event 的内部实现.
重构 co::Pool:
- 用户可以指定 callback ccb 与 dcb，分别用于创建、销毁元素.
- 用户可以指定 pool 的最大容量(仅在 dcb 设置时有效).
- 内部实现中向 Scheduler 注册 cleanup callback，保证在调度线程结束时进行 co::Pool 的清理工作.
co::Kakalot 重命名为 co::PoolGuard.