本文档介绍字符串处理函数的语法与格式、相关的场景示例等。
字符串连接,即用分隔符连接多个字符串。
str_join(separator,value1,value2...)
参数说明如下:
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
---|---|---|---|---|---|
separator | String | 是 | / | / | 分隔符。例如下划线(_)、井号(#)、星号(*)、连字符(-)等。 |
value | String | 是 | / | / | 待连接的值。 |
场景:根据员工名字和公司拼接邮箱地址。
加工规则:
f_set("join",str_join("@",v("name"),v("company")))
日志样例:
{ "name":"zhangsan", "company":"volcengine.com" }
加工结果:
{ "name":"zhangsan", "company":"volcengine.com", "join":"zhangsan@volcengine.com" }
计算字符串长度。
str_len(value)
参数说明如下:
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
---|---|---|---|---|---|
value | String | 是 | / | / | 待计算长度的字段值。 |
场景:获取字段 company
的字符串长度。
加工规则:
f_set("len",str_len(v("company"))
日志样例:
{ "company": "volcengine", "product": "tls" }
加工结果:
{ "company": "volcengine", "product": "tls", "len": 9 }
对字符串中的子串进行多次替换
str_replace(value,old,new,count)
参数说明如下:
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
---|---|---|---|---|---|
value | String | 是 | / | / | 原字符串。 |
old | String | 是 | / | / | 替换前字符串。 |
new | String | 是 | / | / | 替换后字符串。 |
count | Number | 否 | / | count>0 | 替换次数,未设置时默认全部替换。 |
场景:把拼音 shanghai 替换为汉字。
加工规则:
f_set("replace",str_replace(v("region"),"shanghai","上海"))
日志样例:
{ "region": "shanghai" }
加工结果:
{ "region": "上海", "product": "tls" }
字符串格式化。
str_format(format,value1,value2...)
参数说明如下:
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
---|---|---|---|---|---|
separator | String | 是 | / | / | 待格式化字符串,参数用{}代替。 |
value | String | 是 | / | / | 待格式化的值,可变参数。 |
场景:根据省市县街道,拼接出详细地址。
加工规则:
f_set("address",str_format("地址:{}{}{}{}",v("province"),v("city"),v("town"),v("detail")))
日志样例:
{ "province": "四川省", "city": "成都市", "town": "武侯区", "detail": "武侯祠大街231号" }
加工结果:
{ "province": "四川省", "city": "成都市", "town": "武侯区", "detail": "武侯祠大街231号", "address": "地址:四川省成都市武侯区武侯祠大街231号" }