字符串分割是在程序编写过程中经常需要做的事情,如,将字符串:hello world, you are welcome!,进行单词分割,结果希望得到5个单词:hello, world, you, are, welcome。使用 ACL_ARGV 函数便可以非常轻松地实现此功能,如下:
// 分割字符串,分割符为 ' ', '\t', ',', '!'ACL_ARGV *argv = acl_argv_split("hello world, you are welcome!", " \t,!");ACL_ITER iter; // 遍历指针// 遍历分割后的结果acl_foreach(iter, argv) { // 从遍历指针中取出字符串型数据 const char *ptr = (const char*) iter.data; // 打印单词 printf(">>>%s\n", ptr); }// 释放内存acl_argv_free(argv);
由此可见使用ACL_ARGV函数分割字符串是如此简单。此外,因为 ACL_ARGV 结构定义符合 ACL_ITER 规范(参见 ),所以可以直接以 acl_foreach() {} 方式进行遍历。
该例子用到了 lib_acl/include/acl_argv.h 中的两个函数接口,如下:
/** * 根据源字符串及分隔字符串生成一个字符串动态数组 * @param str {const char*} 源字符串 * @param delim {const char*} 分隔字符串 * @return {ACL_ARGV*} */ACL_API ACL_ARGV *acl_argv_split(const char *str, const char *delim);/** * 释放字符串动态数组 * @param argvp {ACL_ARGV*} 字符串动态数组指针 */ACL_API ACL_ARGV *acl_argv_free(ACL_ARGV *argvp);
此外,acl_argv.h 中还提供了其它方便使用的函数接口,如:
/** * 向字符串动态数组中添加一至多个字符串,最后一个NULL字符串表示结束 * @param argvp {ACL_ARGV*} 字符串动态数组指针 * @param ... 字符串列表,最后一个为NULL, 格式如:{s1}, {s2}, ..., NULL */ACL_API void acl_argv_add(ACL_ARGV *argvp,...);/** * 向字符串动态数组中添加字段长度有限制的字符串列表 * @param argvp {ACL_ARGV*} 字符串动态数组指针 * @param ... 一组有长度限制的字符串列表,如: {s1}, {len1}, {s2}, {len2}, ... NULL */ACL_API void acl_argv_addn(ACL_ARGV *argvp,...);/** * 根据源字符串及分隔字符串生成一个字符串动态数组, 但限定最大分隔次数 * @param str {const char*} 源字符串 * @param delim {const char*} 分隔字符串 * @param n {size_t} 最大分隔次数 * @return {ACL_ARGV*} */ACL_API ACL_ARGV *acl_argv_splitn(const char *str, const char *delim, size_t n);/** * 源字符串经分隔符分解后,其结果被附加至一个字符串动态数组 * @param argvp {ACL_ARGV*} 字符串动态数组指针 * @param str {const char*} 源字符串 * @param delim {const char*} 分隔字符串 * @return {ACL_ARGV*} */ACL_API ACL_ARGV *acl_argv_split_append(ACL_ARGV *argvp, const char *str, const char *delim);
这些函数提供了在对字符串进行分割组合时的操作功能。
ACL 库下载位置:http://acl.sourceforge.net/