字符串处理函数

str_count函数

函数介绍

查找字符串中某个子串出现的次数。

语法描述

str_count(value, sub, start, end)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	被查找的字符串
sub	any	是	需要查找的子串
start	number	否	开始查找的位置。 0：第一个字符。
end	number	否	查找结束的位置。 -1：最后一个字符。

示例1

获取字段content中子串abc的数量。

原始日志

{"content":"abc123abc456"}

加工规则

set("count",str_count(v("content"),"abc"))

加工结果

{"content":"abc123abc456","count":2}

str_uppercase函数

函数介绍

将指定字符串中的全部字母转换为大写。

语法描述

str_uppercase(value)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	需要被转换的字符串

示例

将字段content的值转换为大写。

原始日志

{"content":"abc123abc456"}

加工规则

set("upper",str_uppercase(v("content")))

加工结果

{"content":"abc123abc456","upper":"ABC123ABC456"}

str_lowercase函数

函数介绍
将指定字符串中的全部字母转换为小写。

语法描述

str_lowercase(value)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	需要被转换的字符串

示例

将字段content的值转换为大写。

原始日志

{"content":"ABC123ABC456"}

加工规则

set("upper",str_lowercase(v("content")))

加工结果

{"content":"abc123abc456","upper":"abc123abc456"}

str_join函数

函数介绍
使用连接符将多个字符串连接成一个新的字符串。

语法描述

str_join(connector, value1, value2, ....)

参数说明

参数名称	参数类型	是否必填	参数描述
connector	any	是	连接符
value1	any	是	待连接的字符串
value2	any	是	待连接的字符串

示例

将字段province和city使用连接符 “-” 进行连接，并存入新字段address。

原始日志

{"province":"湖北省","city":"武汉市"}

加工规则

set("address",str_join("-",v("province"),v("city")))

加工结果

{"address":"湖北省-武汉市","city":"武汉市","province":"湖北省"}

str_replace函数

函数介绍
将字符串中的指定子串替换为新值。

语法描述

str_replace(value, old, new, count)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	需要被替换的字符串
old	any	是	需要被替换的子串
new	any	是	用于替换的新值
count	any	否	替换次数，0表示替换所有。默认是0

示例

将字段content值中的 “=” 替换为 “:”。

原始日志

{"content":"k1=v1,k2=v2"}

加工规则

set("replaced",str_replace(v("content"),"=",":"))

加工结果

{"content":"k1=v1,k2=v2","replaced":"k1:v1,k2:v2"}

str_format函数

函数介绍
格式化字符串。

语法描述

str_format(format_string, value1, value2, ...)

参数说明

参数名称	参数类型	是否必填	参数描述
format_string	any	是	转换后的字符串格式。占位符：{}
value	any	是	待格式化的值

示例

将字段province和city的值格式化为新字段format。

原始日志

{"province":"湖北","city":"武汉"}

加工规则

set("format",str_format("省份：{}，城市：{}",v("province"),v("city")))

加工结果

{"province":"湖北","city":"武汉","format":"省份：湖北，城市：武汉"}

str_strip函数

函数介绍
删除字符串首尾指定字符集。

语法描述

str_strip(value, chars)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	原字符串
chars	any	否	字符串首尾需要被删除的字符集，默认\t\r\n\v\f

示例1

删除字段content值首尾的空格。

原始日志

{"content":" abc123cba "}

加工规则

set("striped",str_strip(v("content")))

加工结果

{"content":" abc123cba ","striped":"abc123cba"}

示例2

删除字段content值首尾的字符集abc。

原始日志

{"content":"abc123cba"}

加工规则

set("striped",str_strip(v("content"),"abc"))

加工结果

{"content":"abc123cba","striped":"123"}

str_lstrip函数

函数介绍
删除字符串开头的指定字符集。

语法描述

str_lstrip(value, chars)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	原字符串
chars	any	否	字符串开头需要被删除的字符集，默认\t\r\n\v\f

示例1

删除字段content值开头的空格。

原始日志

{"content":" abc123cba "}

加工规则

set("lstriped",str_lstrip(v("content")))

加工结果

{"content":" abc123cba ","lstriped":"abc123cba "}

示例2

删除字段content值开头的字符集abc。

原始日志

{"content":"abccb123cba"}

加工规则

set("lstriped",str_lstrip(v("content"),"abc"))

加工结果

{"content":"abccb123cba","lstriped":"123cba"}

str_rstrip函数

函数介绍
删除字符串结尾的指定字符集。

语法描述

str_rstrip(value, chars)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	原字符串
chars	any	否	字符串结尾需要被删除的字符集，默认\t\r\n\v\f

示例1

删除字段content值结尾的空格。

原始日志

{"content":" abc123cba "}

加工规则

set("rstriped",str_rstrip(v("content")))

加工结果

{"content":" abc123cba ","rstriped":" abc123cba"}

示例2

删除字段content值结尾的字符集abc。

原始日志

{"content":"abccb123cbabc"}

加工规则

set("rstriped",str_rstrip(v("content"),"abc"))

加工结果

{"content":"abccb123cbabc","rstriped":"abccb123"}

str_find函数

函数介绍
判断字符串中是否包含指定子串。返回指定子串在原字符串中出现的索引位置，如果有多个，则只返回第一个。

语法描述

str_find(value, str, begin, end)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	被查找的字符串。
str	any	是	指定查找的子串。
begin	number	否	开始查找的索引位置。0表示第一个字符。默认是0
end	nunber	否	结束查找的索引位置。-1表示最后一个字符。默认是-1

示例

原始日志

{"content":"kingcloud"}

加工规则

set("found_index",str_find(v("content"),"cloud"))

加工结果

{"content":"kingcloud","found_index":4}

str_start_with函数

函数介绍
判断字符串是否以指定子串开头。返回查找结果bool，true表示以指定子串开头。

语法描述

str_start_with(value, prefix, start, end)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	被判断的字符串。
prefix	any	是	指定的前缀子串。
begin	number	否	开始查找的索引位置。0表示第一个字符。默认是0
end	nunber	否	结束查找的索引位置。-1表示最后一个字符。默认是-1

示例

原始日志

{"content":"kingcloud"}

加工规则

set("start-with",str_start_with(v("content"),"king"))

加工结果

{"content":"kingcloud","start-with":true}

str_end_with函数

函数介绍
判断字符串是否以指定子串结尾。返回查找结果bool，true表示以指定子串开头。

语法描述

str_end_with(value, suffix, start, end)

参数说明

参数名称	参数类型	是否必填	参数描述
value	any	是	被判断的字符串。
prefix	any	是	指定的后缀子串。
begin	number	否	开始查找的索引位置。0表示第一个字符。默认是0
end	nunber	否	结束查找的索引位置。-1表示最后一个字符。默认是-1

示例

原始日志

{"content":"kingcloud"}

加工规则

set("end-with",str_end_with(v("content"),"cloud"))

加工结果

{"content":"kingcloud","end-with":true}