tbox里面针对三个正则库（pcre/pcre2/posix）进行了封装，实现接口统一和跨平台处理，只要xmake在编译配置的时候自动检测到其中一种库，就可以使用了，一般会优先使用pcre2。

    如果你不想过多的依赖第三方库，可以切换到posix的正则，调用 xmake f --pcre=false --pcre2=false 把pcre的库禁用了就行了。

    首先给个最简单的匹配单个子串的例子：

    1.     // 执行简单匹配，第二个参数是匹配模式，默认传0就行了
    2.     tb_vector_ref_t results = tb_regex_match_done_simple("(\\w+)\\s+?(\\w+)", 0, "hello world");
    3.     if (results)
    4.     {
    5.         // 遍历匹配到的结果
    6.         tb_for_all_if (tb_regex_match_ref_t, entry, results, entry)
    7.         {
    8.             // 打印匹配到的子串的起始偏移、长度、和内容
    9.             tb_trace_i("[%lu, %lu]: %s", entry->start, entry->size, entry->cstr);
    10.         }
    11.  
    12.         // 销毁匹配到的结果数据
    13.         tb_vector_exit(results);
    14.     }

    输出结果如下：

    1. [0, 11]: hello world 
    2. [0, 5]: hello
    3. [6, 5]: world

    第一个匹配结果，是针对整个匹配子串的，后面两个结果，是针对()里面的分组匹配。。

    如果不想进行遍历，只像提取其中第一个分组匹配的结果，可以这么使用：

    1.     // 执行简单匹配，第二个参数是匹配模式，默认传0就行了
    2.     tb_vector_ref_t results = tb_regex_match_done_simple("(\\w+)\\s+?(\\w+)", 0, "hello world");
    3.     if (results && tb_vector_size(results) > 1)
    4.     {
    5.         // 获取第一个分组结果，也就是索引1的子串
    6.         tb_regex_match_ref_t entry = (tb_regex_match_ref_t)tb_iterator_item(results, 1);
    7.         if (entry)
    8.         {
    9.             // 打印匹配到的子串的起始偏移、长度、和内容
    10.             tb_trace_i("[%lu, %lu]: %s", entry->start, entry->size, entry->cstr);
    11.         }
    12.  
    13.         // 销毁匹配到的结果数据
    14.         tb_vector_exit(results);
    15.     }

    上面只能匹配全文中的第一个字串，如果想要进行全局匹配，可以这么来：

    1.     // 初始化一个正则对象，采用默认匹配模式
    2.     tb_regex_ref_t regex = tb_regex_init("\\w+", 0);
    3.     if (regex)
    4.     {
    5.         // 循环匹配全部子串
    6.         tb_long_t       start = 0;
    7.         tb_size_t       length = 0;
    8.         tb_vector_ref_t results = tb_null;
    9.         while ((start = tb_regex_match_cstr(regex, content, start + length, &length, &results)) >= 0 && results)
    10.         {
    11.             // 整个子串的起始偏移和长度（不是分组子串，是整个匹配串）
    12.             tb_trace_i("[%lu, %lu]: ", start, length);
    13.  
    14.             // 遍历显示这个匹配子串的所有分组，第一项是整个子串
    15.             tb_for_all_if (tb_regex_match_ref_t, entry, results, entry)
    16.             {
    17.                 // trace
    18.                 tb_trace_i("    [%lu, %lu]: %s", entry->start, entry->size, entry->cstr);
    19.             }
    20.         }
    21.  
    22.         // 销毁正则对象
    23.         tb_regex_exit(regex);
    24.     }

    用 tb_regex_init 创建一个正则对象的方式，针对匹配次数频繁的操作，进行了优化，因为它会提前预编译正则表达式

    如果只是进行单一子串匹配，那么使用tb_regex_match_done_simple就够用了，毕竟接口更加简单易用

    需要注意的是，用 tb_regex_init 进行的所有匹配结果和替换结果，是不需要手动销毁释放的，在调用tb_regex_exit，会去自动释放他们

    前面传递的匹配模式，只传了0，使用默认匹配规则，tbox目前可以支持以下模式：

    1.     TB_REGEX_MODE_NONE              = 0     //!< 默认匹配模式
    2. ,   TB_REGEX_MODE_CASELESS          = 1     //!< 忽略大小写匹配
    3. ,   TB_REGEX_MODE_MULTILINE         = 2     //!< ^ 和 $ 匹配新行，实现多行匹配
    4. ,   TB_REGEX_MODE_GLOBAL            = 4     //!< 执行全局替换

    替换子串更加方便，如果替换单次子串，只需要：

    1.     // 执行单次替换
    2.     tb_char_t const* results = tb_regex_replace_done_simple("\\w+", 0, "hello world", "hi");
    3.     if (results)
    4.     {
    5.         // trace
    6.         tb_trace_i(": %s", results);
    7.  
    8.         // 销毁结果字串
    9.         tb_free(results);
    10.     }

    输出结果如下：

    1. hi world

    如果要进行多次全局替换，只需修改匹配模式：

    1.     // 设置TB_REGEX_MODE_GLOBAL全局替换模式，执行多次替换
    2.     tb_char_t const* results = tb_regex_replace_done_simple("\\w+", TB_REGEX_MODE_GLOBAL, "hello world", "hi");
    3.     if (results)
    4.     {
    5.         // trace
    6.         tb_trace_i(": %s", results);
    7.  
    8.         // 销毁结果字串
    9.         tb_free(results);
    10.     }

    输出结果如下：

    1. hi hi

    当然如果同一个正则替换不同文本的操作很频繁，那么先用 tb_regex_init("\\w+", TB_REGEX_MODE_GLOBAL) 创建个正则对象来替换，这样效率会高很多，这个就看具体实际需要了。。