tbox

类似 glib 的跨平台 C 库

支持项目

成为赞助商来支持该项目。您的徽标将显示在此处，并带有指向您网站的链接。 [成为赞助商]

简介 (中​​文)

TBOX 是一个类似 glib 的跨平台 C 库，使用简单但本质上功能强大。

该项目专注于让C开发变得更容易，并提供了许多模块（例如流、协程、正则表达式、容器、算法...），以便任何开发人员都可以快速上手并享受使用C语言开发时的生产力提升。

它支持以下平台：Windows、Macosx、Linux、Android、iOS、*BSD 等。

并且它使用 xmake 提供了许多编译选项：

• 发布：禁用调试信息、断言、内存检查并启用优化。
• 调试：启用调试信息、断言、内存检查并禁用优化。
• 小：禁用所有扩展模块并启用空间优化。
• Micro：为嵌入式系统编译微型库（~64K）。

如果想了解更多请参考：文档、Github和Gitee

特征

流库

• 支持文件、数据、http 和套接字源
• 支持 gzip、字符集和...的流过滤器
• 实现流传输
• 实现用于解析数据的静态缓冲流
• 支持协程，实现异步操作

协程库

• 提供高性能协程切换
• 支持arm、arm64、x86、x86_64 ..
• 提供通道接口
• 提供信号量和锁接口
• 支持协程中的io套接字和流操作
• 使用协程提供一些 io 服务器（http ..）
• 提供 stackfull 和 stackless 协程
• 支持epoll、kqueue、poll、select和IOCP
• 支持协程和轮询器中同时等待管道、套接字和进程

数据库库

• 支持mysql和sqlite3数据库，并使用迭代器模式枚举数据

xml 解析器库

• 支持DOM和SAX模式并支持xpath

序列化和反序列化库

• 支持xml、json、bplist、xplist、二进制格式

记忆库

• 实现一些内存池以优化内存
• 支持快速内存错误检测。它可以在调试模式下检测以下类型的错误：
  • 对堆和全局变量的越界访问
  • 释放后使用
  • 双重释放、无效释放
  • 内存泄漏

容器库

• 实现哈希表、单列表、双列表、向量、堆栈、队列和最小/最大堆。支持算法的迭代器模式

算法库

• 使用迭代器模式
• 实现查找、二进制查找和反向查找算法
• 实现排序、冒泡排序、快速排序、堆排序和插入排序算法
• 实现计数、遍历项目、反向遍历项目、for_all 和 rfor_all

网络图书馆

• 实现 dns（缓存）
• 实现 ssl(openssl、polarssl、mbedtls)
• 实现http
• 实施cookies
• 支持ipv4、ipv6
• 支持协程

平台库

• 实现定时器，快速低精度定时器
• 实现原子和atomic64操作
• 实现自旋锁、互斥锁、事件、信号量、线程和线程池
• 实现文件、socket操作
• 使用 epoll、poll、select、kqueue ... 实现轮询器
• 实现协程的切换上下文接口

字符集库

• 支持utf8、utf16、gbk、gb2312、uc2和uc4
• 支持大端和小端模式

邮编库

• 使用 zlib 库（如果存在）支持 gzip、zlibraw、zlib 格式
• 实现lzsw、lz77和rlc算法

实用程序库

• 实现base32、base64编码器和解码器
• 实现调试模式的断言和跟踪输出
• 实现解析 u8、u16、u32、u64 数据的位操作

数学图书馆

• 实现随机生成器
• 实现快速定点计算，支持6位、16位、30位定点数

libc 库

• 实现轻量级libc库接口，接口名称包含tb_xxx前缀以避免冲突
• 实现 strixxx strrxxx wcsixxx wcsrxxx 接口扩展
• 优化一些常用接口，例如memset、memcpy、strcpy ...
• 实现memset_u16 、 memset_u32 、 memset_u64扩展接口

libm 库

• 实现轻量级libm库接口，接口名称包含tb_xxx前缀以避免冲突
• 支持float和double类型

正则表达式库

• 支持匹配和替换
• 支持全局/多行/无大小写模式
• 使用 pcre、pcre2 和 posix 正则表达式模块

哈希库

• 实现crc32、adler32、md5和sha1哈希算法
• 实现一些字符串哈希算法（例如bkdr、fnv32、fnv64、sdbm、djb2、rshash、aphash ...）
• 实现 uuid 生成器

项目

使用tbox的一些项目：

• 格盒
• 虚拟机86
• xmake
• 伊特拉斯
• 更多的

构建（xmake）

请先安装xmake：xmake

# build for the host platform
$ cd ./tbox
$ xmake

# build for the mingw platform
$ cd ./tbox
$ xmake f -p mingw --sdk=/home/mingwsdk
$ xmake

# build for the iphoneos platform
$ cd ./tbox
$ xmake f -p iphoneos
$ xmake

# build for the android platform
$ cd ./tbox
$ xmake f -p android --ndk=xxxxx
$ xmake

# build for the linux cross-platform
$ cd ./tbox
$ xmake f -p linux --sdk=/home/sdk # --bin=/home/sdk/bin
$ xmake 

构建（xmake.sh）

$ ./configure
$ make 

例子

 #include "tbox/tbox.h"

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

    tb_vector_ref_t vector = tb_vector_init ( 0 , tb_element_str ( tb_true ));
    if ( vector ) {
        tb_vector_insert_tail ( vector , "hello" );
        tb_vector_insert_tail ( vector , "tbox" );

        tb_for_all ( tb_char_t const * , cstr , vector ) {
            tb_trace_i ( "%s" , cstr );
        }
        tb_vector_exit ( vector );
    }
    tb_exit ();
    return 0 ;
}

技术支援

您也可以考虑赞助我们获得技术支持服务，【成为赞助商】

联系方式

• 邮箱：[email protected]
• 主页：tboox.org
• 社区：reddit 上的/r/tboox
• ChatRoom：电报聊天、gitter 聊天
• QQ群：343118190（已满）、662147501
• 微信公众号：tboox-os