tbox里面针对三个正则库(pcre/pcre2/posix)进行了封装,实现接口统一和跨平台处理,只要xmake在编译配置的时候自动检测到其中一种库,就可使用了,通常会优先使用pcre2。git
若是你不想过多的依赖第三方库,能够切换到posix的正则,调用 xmake f --pcre=false --pcre2=false
把pcre的库禁用了就好了。github
首先给个最简单的匹配单个子串的例子:正则表达式
// 执行简单匹配,第二个参数是匹配模式,默认传0就好了 tb_vector_ref_t results = tb_regex_match_done_simple("(\\w+)\\s+?(\\w+)", 0, "hello world"); if (results) { // 遍历匹配到的结果 tb_for_all_if (tb_regex_match_ref_t, entry, results, entry) { // 打印匹配到的子串的起始偏移、长度、和内容 tb_trace_i("[%lu, %lu]: %s", entry->start, entry->size, entry->cstr); } // 销毁匹配到的结果数据 tb_vector_exit(results); }
输出结果以下:优化
[0, 11]: hello world [0, 5]: hello [6, 5]: world
第一个匹配结果,是针对整个匹配子串的,后面两个结果,是针对()里面的分组匹配。。.net
若是不想进行遍历,只像提取其中第一个分组匹配的结果,能够这么使用:code
// 执行简单匹配,第二个参数是匹配模式,默认传0就好了 tb_vector_ref_t results = tb_regex_match_done_simple("(\\w+)\\s+?(\\w+)", 0, "hello world"); if (results && tb_vector_size(results) > 1) { // 获取第一个分组结果,也就是索引1的子串 tb_regex_match_ref_t entry = (tb_regex_match_ref_t)tb_iterator_item(results, 1); if (entry) { // 打印匹配到的子串的起始偏移、长度、和内容 tb_trace_i("[%lu, %lu]: %s", entry->start, entry->size, entry->cstr); } // 销毁匹配到的结果数据 tb_vector_exit(results); }
上面只能匹配全文中的第一个字串,若是想要进行全局匹配,能够这么来:对象
// 初始化一个正则对象,采用默认匹配模式 tb_regex_ref_t regex = tb_regex_init("\\w+", 0); if (regex) { // 循环匹配所有子串 tb_long_t start = 0; tb_size_t length = 0; tb_vector_ref_t results = tb_null; while ((start = tb_regex_match_cstr(regex, content, start + length, &length, &results)) >= 0 && results) { // 整个子串的起始偏移和长度(不是分组子串,是整个匹配串) tb_trace_i("[%lu, %lu]: ", start, length); // 遍历显示这个匹配子串的全部分组,第一项是整个子串 tb_for_all_if (tb_regex_match_ref_t, entry, results, entry) { // trace tb_trace_i(" [%lu, %lu]: %s", entry->start, entry->size, entry->cstr); } } // 销毁正则对象 tb_regex_exit(regex); }
用 tb_regex_init
建立一个正则对象的方式,针对匹配次数频繁的操做,进行了优化,由于它会提早预编译正则表达式索引
若是只是进行单一子串匹配,那么使用tb_regex_match_done_simple
就够用了,毕竟接口更加简单易用接口
须要注意的是,用 tb_regex_init
进行的全部匹配结果和替换结果,是不须要手动销毁释放的,在调用tb_regex_exit
,会去自动释放他们文档
前面传递的匹配模式,只传了0,使用默认匹配规则,tbox目前能够支持如下模式:
TB_REGEX_MODE_NONE = 0 //!< 默认匹配模式 , TB_REGEX_MODE_CASELESS = 1 //!< 忽略大小写匹配 , TB_REGEX_MODE_MULTILINE = 2 //!< ^ 和 $ 匹配新行,实现多行匹配 , TB_REGEX_MODE_GLOBAL = 4 //!< 执行全局替换
替换子串更加方便,若是替换单次子串,只须要:
// 执行单次替换 tb_char_t const* results = tb_regex_replace_done_simple("\\w+", 0, "hello world", "hi"); if (results) { // trace tb_trace_i(": %s", results); // 销毁结果字串 tb_free(results); }
输出结果以下:
hi world
若是要进行屡次全局替换,只需修改匹配模式:
// 设置TB_REGEX_MODE_GLOBAL全局替换模式,执行屡次替换 tb_char_t const* results = tb_regex_replace_done_simple("\\w+", TB_REGEX_MODE_GLOBAL, "hello world", "hi"); if (results) { // trace tb_trace_i(": %s", results); // 销毁结果字串 tb_free(results); }
输出结果以下:
hi hi
固然若是同一个正则替换不一样文本的操做很频繁,那么先用 tb_regex_init("\\w+", TB_REGEX_MODE_GLOBAL)
建立个正则对象来替换,这样效率会高不少,这个就看具体实际须要了。。