玩 c 的同学快进来，推荐个跨平台 c 库给你们

[waruqi]

最近终于腾出时间把两年前的 issues#24给解决了，现在 windows 上已经完全支持基于 IOCP 的协程 io 处理。

大家有兴趣的话，或者有需要用 c 开发跨平台程序的同学可以关注下哦，里面有各种常用模块，并且提供了灵活的裁剪编译模式，方便大家只编译使用需要的模块。

摆着代码即文档的原则，实现接口都有详细注释说明，同时 TBOX 也是个代码仓库，大家如果在写系统程序的时候，一些系统接口的使用可以在 tbox 的源码的 platform 目录中搜索，找到相关实现来做参考哦。

前两天刚好发了新版本(v1.6.3)，花了我一年多时间修复了各种问题，不过中途又跑去捣鼓xmake(一个基于 lua 的跨平台编译工具)了，大家也可以关注下，嘿嘿。

简介

TBOX 是一个用 c 语言实现的跨平台开发库。

针对各个平台，封装了统一的接口，简化了各类开发过程中常用操作，使你在开发过程中，更加关注实际应用的开发，而不是把时间浪费在琐碎的接口兼容性上面，并且充分利用了各个平台独有的一些特性进行优化。

这个项目的目的，是为了使 C 开发更加的简单高效。

目前支持的平台有：

• Windows
• Macosx
• Linux
• Android
• iOS

通过xmake支持各种编译模式：

• Release: 正式版编译，禁用调试信息、断言，各种检测机制，启用编译器优化
• Debug: 调试模式，默认启用详细调试信息、断言、内存越界检测、内存泄漏、锁竞争分析等检测机制
• Small: 最小化编译，默认禁用所有扩展模块，启用编译器最小化优化
• Micro: 针对嵌入式平台，仅仅编译 tbox 微内核，仅提供最基础的跨平台接口，生成库仅 64K 左右（内置轻量 libc 接口实现）

如果你想了解更多，请参考：

• 项目主页
• 在线文档
• Github
• Gitee

特性

流库

针对 http、file、socket、data 等流数据，实现统一接口进行读写，并且支持: 阻塞、非阻塞、异步 三种读写模式。 支持中间增加多层 filter 流进行流过滤，实现边读取，内部边进行解压、编码转换、加密等操作，极大的减少了内存使用。

主要提供以下模块：

• stream：通用非阻塞流，用于一般的单独 io 处理，同时支持协程以实现异步传输。
• transfer：流传输器，维护两路流的传输。
• static_stream：针对静态数据 buffer 优化的静态流，用于轻量快速的数据解析。

协程库

• 快速高效的协程切换支持
• 提供跨平台支持，核心切换算法参考 boost，并且对其进行重写和优化，目前支持架构：x86, x86_64, arm, arm64, mips32
• 提供 channel 协程间数据通信支持，基于生产、消费者模型
• 提供信号量、协程锁支持
• socket、stream 都模块原生支持协程，并且可在线程和协程间进行无缝切换
• 提供 http、file 等基于协程的简单服务器实例，只需几百行代码，就可以从 socket 开始写个高性能 io 服务器，代码逻辑比异步回调模式更加清晰
• 同时提供 stackfull, stackless 两种协程模式支持，stackless 协程更加的轻量（每个协程只占用几十个 bytes ），切换更快（会牺牲部分易用性）
• 支持 epoll, kqueue, poll, select 和 IOCP

数据库

• 统一并简化数据库操作接口，适配各种数据源，通过统一的 url 来自动连接打开支持的数据库，数据的枚举采用迭代器模型。
• 目前支持 sqlite3 以及 mysql 两种关系型数据库，也可自定义扩展使用其他关系型数据库。

xml 库

• 针对 xml 提供 DOM 和 SAX 两种解析模式，SAX 方式采用外部迭代模式，灵活性和性能更高，并且可以选择指定路径，进行解析。
• 解析过程完全基于 stream，所以是高度流化的，可以实现边下载、边解压、边转码、边解析一条龙服务，使用较低的内存也可以解析大规模数据。
• 提供 xml writer 以支持对 xml 生成

内存库

• 参考 linux 内核内存管理机制的实现，并对其进行各种改造和优化，所实现的 TBOX 独有的一整套内存池管理架构。
• 调试模式下，可以轻松检测并定位内存泄露、内存越界溢出、内存重叠覆盖等常见内存问题，并对整体内存的使用进行了统计和简要分析。
• 针对大块数据、小块数据、字符串数据进行了充分的利用，避免了大量外部碎片和内部碎片的产生。分配操作进行了各种优化，96%的情况下，效率都是在 O(1)。

容器库

• 提供哈希、链表、数组、队列、堆栈、最小最大堆等常用容器。
• 支持各种常用成员类型，在原有的容器期初上，其成员类型还可以完全自定义扩展。
• 所有容器都支持迭代器操作。
• 大部分容器都可以支持基于 stream 的序列化和反序列化操作。

算法库

• 提供各种排序算法：冒泡排序、堆排序、快速排序、插入排序。
• 提供各种查找算法：线性遍历、二分法搜索。
• 提供各种遍历、删除、统计算法。
• 以迭代器为接口，实现算法和容器的分离，类似 stl，但是 c 实现的，更加轻量。

网络库

• 实现 http 客户端模块
• 实现 cookies
• 实现 dns 解析与缓存
• 实现 ssl(支持 openssl, polarssl, mbedtls)
• 支持 ipv4、ipv6
• 支持通过协程实现异步模式

数学运算库

• 提供各种精度的定点运算支持
• 提供随机数生成器

libc 库

• libc 的一个轻量级实现，完全跨平台，并且针对不同架构进行了优化。
• 支持大部分字符串、宽字符串操作。
• 扩展字符串、宽字符串的各种大小写不敏感操作接口
• 扩展memset_u16、memset_u32等接口，并对其进行高度优化，尤其适合图形渲染程序

libm 库

• libm 部分接口的一个轻量级实现，以及对常用系统接口的封装。（目前只实现了部分，之后有时间会完全实现掉）
• 扩展部分常用接口，增加对 sqrt、log2 等常用函数的整数版本计算，进行高度优化，不涉及浮点运算，适合嵌入式环境使用。

object 库

• 轻量级类 apple 的 CoreFoundation 库，支持 object、dictionary、array、string、number、date、data 等常用对象，并且可以方便扩展自定义对象的序列化。
• 支持对 xml、json、binary 以及 apple 的 plist(xplist/bplist)格式序列化和反序列化。 并且实现自有的 binary 序列化格式， 针对明文进行了简单的加密，在不影响性能的前提下，序列化后的大小比 bplist 节省 30%。

平台库

• 提供 file、directory、socket、thread、time 等常用系统接口
• 提供 atomic、atomic64 接口
• 提供高精度、低精度定时器
• 提供高性能的线程池操作
• 提供 event、mutex、semaphore、spinlock 等事件、互斥、信号量、自旋锁操作
• 提供获取函数堆栈信息的接口，方便调试和错误定位
• 提供跨平台动态库加载接口（如果系统支持的话）
• 提供 io 轮询器，针对 epoll, poll, select, kqueue 进行跨平台封装
• 提供跨平台上下文切换接口，主要用于协程实现，切换效率非常高

压缩库

• 支持 zlib/zlibraw/gzip 的压缩与解压（需要第三方 zlib 库支持）。

字符编码库

• 支持 utf8、utf16、gbk、gb2312、uc2、uc4 之间的互相转码，并且支持大小端格式。

实用工具库

• 实现 base64/32 编解码
• 实现 crc32、adler32、md5、sha1 等常用 hash 算法
• 实现日志输出、断言等辅助调试工具
• 实现 url 编解码
• 实现位操作相关接口，支持各种数据格式的解析，可以对 8bits、16bits、32bits、64bits、float、double 以及任意 bits 的字段进行解析操作，并且同时支持大端、小端和本地端模式，并针对部分操作进行了优化，像 static_stream、stream 都有相关接口对其进行了封装，方便在流上进行快速数据解析。
• 实现 swap16、swap32、swap64 等位交换操作，并针对各个平台进行了优化。
• 实现一些高级的位处理接口，例如：位 0 的快速统计、前导 0 和前导 1 的快速位计数、后导 01 的快速位计数
• 实现单例模块，可以对静态对象、实例对象进行快速的单例封装，实现全局线程安全
• 实现 option 模块，对命令行参数进行解析，提供快速方便的命令行选项建立和解析操作，对于写终端程序还是很有帮助的

正则表达式库

• 支持匹配和替换操作
• 支持全局、多行、大小写不敏感等模式
• 使用 pcre, pcre2 和 posix 正则库

一些使用 tbox 的项目：

• gbox
• vm86
• xmake
• itrace
• 更多项目

编译

请先安装: xmake

# 默认直接编译当前主机平台
$ cd ./tbox
$ xmake

# 编译 mingw 平台
$ cd ./tbox
$ xmake f -p mingw --sdk=/home/mingwsdk 
$ xmake

# 编译 iphoneos 平台
$ cd ./tbox
$ xmake f -p iphoneos 
$ xmake

# 编译 android 平台
$ cd ./tbox
$ xmake f -p android --ndk=xxxxx
$ xmake

# 交叉编译
$ cd ./tbox
$ xmake f -p linux --sdk=/home/sdk #--bin=/home/sdk/bin
$ xmake

例子

#include "tbox/tbox.h"

int main(int argc, char** argv)
{
    // init tbox
    if (!tb_init(tb_null, tb_null)) return 0;

    // trace
    tb_trace_i("hello tbox");

    // init vector
    tb_vector_ref_t vector = tb_vector_init(0, tb_element_cstr(tb_true));
    if (vector)
    {
        // insert item
        tb_vector_insert_tail(vector, "hello");
        tb_vector_insert_tail(vector, "tbox");

        // dump all items
        tb_for_all (tb_char_t const*, cstr, vector)
        {
            // trace
            tb_trace_i("%s", cstr);
        }

        // exit vector
        tb_vector_exit(vector);
    }

    // init stream
    tb_stream_ref_t stream = tb_stream_init_from_url("http://www.xxx.com/file.txt");
    if (stream)
    {
        // open stream
        if (tb_stream_open(stream))
        {
            // read line
            tb_long_t size = 0;
            tb_char_t line[TB_STREAM_BLOCK_MAXN];
            while ((size = tb_stream_bread_line(stream, line, sizeof(line))) >= 0)
            {
                // trace
                tb_trace_i("line: %s", line);
            }
        }

        // exit stream
        tb_stream_exit(stream);
    }

    // wait 
    getchar();

    // exit tbox
    tb_exit();
    return 0;
}

[scuxhy]

支持！

[hourann]

神级大佬

[xiaket]

今天在 Lobster 上也看到人推荐这个库了, 仔细一看就是你本人~ 加油!

[maowu]

看了半天，没有 gui 库(:3_ヽ)_

[waruqi]

@maowu 只是个基础库，gui 之前原本也想另起个轮子的，后来时间精力不够，所以我还是先专心把基础库搞好吧。

[cchange]

支持
支持 sqlite 对嵌入式和 低耦合的项目很有帮助

[waruqi]

@xiaket 是啊 昨晚我上面也去晒了下。: )

[waruqi]

@cchange 谢谢支持

[salamanderMH]

东西好多

[nflush]

请问是什么开源协议？

[mm163]

收藏了，功能丰富。

[waruqi]

@nflush Apache License 2.0

[ragnaroks]

windows 下的话,对 vcrt 有什么要求吗?准备在我的新项目(C#)里面用

[innoink]

请问有用过 acl 的没

[waruqi]

@ragnaroks vcrt? crt? 没有特殊要求，你可以试下

[diggerdu]

强 star 一波

[waruqi]

@innoink 郑老大的库，很赞！

[waruqi]

@diggerdu 谢谢!

[hhacker]

天哪 一大早被楼主的代码美哭了，这个库好整洁好舒适啊

[waruqi]

@hhacker 谢谢，有点小洁癖。。：）

[zeromake]

遗憾的是如果能做成打包并分发到在线依赖下载就好了，支持打包当前平台然后共享。
也可以打包源码加 xmake 多平台编译方式，类似 python 的 pip 里的带 c 扩展类的包。
我觉得已经有很多人做了支持 xmake 编译的库，没有一种好的分享方式。
首先需要定义一个打包规范，linux 各种库的包实质就是单平台单版本的库分发。

[ifanze]

支持！向大佬学习！

[catcn]

代码里边好多多余的注释

[waruqi]

@zeromake xmake 有提供自己的打包规范，执行 xmake package，就可以打包出 xxx.pkg 包（支持多 arch，多平台），其他基于 xmake 的项目，也可以直接快速使用，并且 xmake 目前正在开发包管理 3.0，对于支持 xmake 的依赖库，可以支持依赖下载管理。

如果你有兴趣的话，可以看下这个演示视频： https://asciinema.org/a/140338

和对应的 issues： https://github.com/tboox/xmake/issues/69 虽然对于非 xmake 的依赖库，还支持不完善，但是对于支持 xmake 的依赖库，目前已经可以通过依赖管理的方式使用了，并且可以自建依赖仓库，或者上传至官方仓库： https://github.com/tboox/xmake-repo

[waruqi]

@catcn 是有很多冗余，不过我习惯了敲几行带点绿，看着舒爽。。= =

[tt67wq]

看不懂，先摩拜

[q397064399]

老哥 有机会整个 cmake ， 编译这东西 建议用 广泛使用的工具，这样集成的时候也方便，，像 Java maven 一个 denpency 就完事，然后就是愉快的敲代码了

[freemon]

膜一个

[allgy]

mark 有时间读一读大佬的源码

[alamaya]

真大佬

[axeojpwt]

准备拜读一下楼主的代码，看起来代码很优雅，第一眼就很美观。

[MarcoQin]

star 了，很多功能的聚合，看起来很方便

[waruqi]

@axeojpwt 谢谢

[waruqi]

@q397064399 cmake 个人不喜欢，所以才自己整的 xmake，不过对于其他习惯使用 cmake 的用户来说，整合 tbox 库确实不方便了，我后期会考虑在 xmake 加个，自动导出生成 CMakeList.txt 的功能，来方便与 cmake 的集成。

[Applenice]

已 star,膜拜大佬

[Yggdroot]

👍👍👍

[aice114]

厉害厉害,楼主堪称注释狂魔

[boywhp]

向大佬低头， 玩 C 的惹不起惹不起

[mathzhaoliang]

楼主的项目很好，我有个疑问，非抬杠：数据结构，正则这些东西都有现成的成熟库，自己再造一遍轮子的话，如果造的比那些库还好，那当然好。若只是实现一个较弱的版本，意义似乎不大？

[closedevice]

牛逼~

[waruqi]

@mathzhaoliang 不是再造，仅仅只是封装，统一成跨平台的接口，比如正则，tbox 会去自动检测当前系统是否有 pcre2, pcre，regex 等正则库，如果存在则直接使用（如果有的话，优先使用 pcre2 ）

并提供统一的接口，用户不需要关心每个正则库使用的方式，只需要用 tbox 提供的接口实现正则解析后，就可以无缝随意切换到其他正则库上去。

[zeromake]

@waruqi 好像还不错，就是没有个集中的依赖站点，如果 github 日常被墙就很难受，只有有了集中的依赖站才好做镜像吧。

[E1n]

呜呜 C 好久没看了，写 C 吃不上饭

[xi2008wang]

我是看着你代码长大的，不，看着你代码学习 C 的

[waruqi]

@zeromake 可以自建仓库的，官方 repo，除了 github，还有提供 oschina/gitee 的国内镜像 repo https://gitee.com/tboox/xmake-repo

[waruqi]

@E1n 跟吃饭没啥关系，我现在主业也不是做 c 的，只要有兴趣就可以玩。

[waruqi]

@xi2008wang 别这样，把我说老了。。。= =

[lurenw]

名字有趣，treasure box~

想知道楼主花了多少时间来掌握这些技术栈，累积这么多的知识储备

[waruqi]

@lurenw 哈哈，就是百宝箱的意思，写这个库快 8 年多了吧，再早之前写过个类似 boost 的 c++模板库，功能跟这个类似，不过后来转 c 了，就重新整了个 c 版本的，用到了现在。

[zhuangzhuang1988]

头疼 qmake cmake nmake makefile automake scons jam gyp ninja
现在又来了个 xmake

[zeromake]

@waruqi #45 不是说这个，不提供一个统一的代码仓库，最后就会变得和 `golang` 的一样，一个项目依赖来自各种墙外网点，官方 repo 的方案就需要人手动维护，同步到 oschina/gitee 也是很麻烦。总之如果像 golang 一样的话我宁愿直接下个各个依赖直接放进项目做直接依赖而不是远程依赖。

[waruqi]

@zeromake 如果要完全同意，不依赖各种墙外各种网点，目前通过源码依赖的方式，不太好做，总归要去下载其他托管的源码地址，只能通过二进制包管理的方式 提供统一仓库，这个维护成本很高，暂时不考虑自己去建立和维护了。

目前 xmake 仅支持源码依赖编译管理的方式，后期会对于非 xmake 的依赖库，适配系统已有的包管理，例如：brew, vcpkg, apt/pacman 等，进行二进制包的 依赖管理和下载。

[waruqi]

@zhuangzhuang1988 哈哈

[zeromake]

@waruqi #52 这个我觉得可以考虑做一个，可以像 pypi 一样，反正这些二进制包都是依赖库维护自己本地打二进制包，偷懒的就只发源码包，最后发现要求和 pypi 十分接近呢，果然是用多了。

[waruqi]

@zeromake 理论上这样确实会更好，但是这样维护成本太高了，我就一个人，没这么多精力捣鼓哈，而且也不太好推动，暂时只考虑复用现有的第三方包管理工具，而源码依赖编译，如果基于 xmake 的，可以提交 xmake-repo 官方仓库，或者自建私有依赖仓库。

[SPACELAN]

遇到大神了

顺便问一下，有文件监控之类的事件库么

[zeromake]

@waruqi 那等我把自己一个 orm 自动转 api 的 py 库做完，用它做个开源依赖站看看，这个到时到 xmake 的 issues 去讨论吧。

[waruqi]

@SPACELAN 没有，目前仅提供一些最常用、最基础的模块。

[waruqi]

@zeromake 可以

[firenine]

有点冒昧，感觉使用并不是很广，只看见楼主几个项目在用，基础库选择的时候还是要比较慎重

[waruqi]

@firenine 对的 目前用的人不是很多。开源项目中 估计也就我在用了，大部分用户都用在私有项目上，不过用户量确实不多

我也没怎么去推广，上次推广还是一年前的事了，目前主要还是个人使用，偶尔出来分享下。。= =

[zn]

膜拜大佬。

[d18]

哇

[kylix]

先收藏再慢慢看！

[MeteorCat]

最近 github 拉代码越来越卡了，不知道为什么，刚刚拉代码又超时了

[waruqi]

@MeteorCat 可以拉国内镜像，同步更新的，https://gitee.com/tboox/tbox

[MeteorCat]

@waruqi 感谢了，一直惯性到 github 拉取，我换下这个看看

[nicevar]

不错，收藏了，star 一波

[waruqi]

@nicevar 谢谢

[caikelun]

厉害了！

[FanWall]

以前就被人推荐过这个库，今天发现作者了

[desgard]

顶一下楼主，真的强

[waruqi]

@desgard 多谢支持。：）

[ai277014717]

强烈支持，问下写这个库的灵感来自哪里？

[waruqi]

@ai277014717 来自于日常积累。。

[Simon90]

厉害了，学习！

[Shazoo]

赞一个。star 了。一看就是老司机，日积月累积攒下来，很多都是痛点库。

不过看了下代码。非 posix 的嵌入式系统里面，可用的东西不多。不过，这种系统，本身也没啥跨平台需求，不强求。

[waruqi]

@Shazoo 是的 非 posix 的 目前确实没太多支持 不过可自己根据需求 扩展下 platform 目录下对应接口 适配集成下 也不是很麻烦。。

[Alonso]

膜拜大佬

[nonkr]

膜拜大佬，花时间好好拜读一下~~

[nanlou]

大佬大佬，star 一个。。

[waruqi]

@Alonso
@nonkr
@nanlou 谢谢

[Hconk]

支持，非常棒。。

[simpx]

太强了，一看就是长期积累出来的

@waruqi 大佬工作中也用自己的这个库吗？

[waruqi]

@simpx 之前工作中用过，现在主要用于个人项目

[gozfree]

@SPACELAN 文件监控刚好我有实现过
https://github.com/gozfree/libraries/tree/master/libfilewatcher

[gozfree]

感谢作者的贡献，很好的 C 库，收藏了

[waruqi]

@gozfree 谢谢支持