tencent cloud

日志服务

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
地域和访问域名
规格与限制
基本概念
购买指南
计费概述
产品定价
按量计费（后付费）
欠费说明
清理日志服务资源
成本优化
常见问题
快速入门
一分钟入门指南
入门指南
使用 Demo 日志快速体验 CLS
操作指南
资源管理
权限管理
日志采集
指标采集
日志存储
指标存储
检索分析（日志主题）
检索分析（指标主题）
仪表盘
数据处理
投递与消费
监控告警
云产品中心
DataSight 独立控制台
历史文档
实践教程
日志采集
检索分析
仪表盘
监控告警
投递和消费
成本优化
开发者指南
通过 iframe 内嵌 CLS（旧方案）
通过 Grafana 使用 CLS
API 文档
History
Introduction
API Category
Making API Requests
Topic Management APIs
Log Set Management APIs
Index APIs
Topic Partition APIs
Machine Group APIs
Collection Configuration APIs
Log APIs
Metric APIs
Alarm Policy APIs
Data Processing APIs
Kafka Protocol Consumption APIs
CKafka Shipping Task APIs
Kafka Data Subscription APIs
COS Shipping Task APIs
SCF Delivery Task APIs
Scheduled SQL Analysis APIs
COS Data Import Task APIs
Data Types
Error Codes
常见问题
健康监测问题解释
采集相关
检索分析相关
其他问题
服务等级协议
CLS 政策
隐私协议
数据处理和安全协议
联系我们
词汇表
文档日志服务操作指南数据处理数据加工数据加工函数字符串处理函数

字符串处理函数

PDF
聚焦模式
字号
最后更新时间： 2026-01-07 15:50:14

简介

字符串处理函数，支持字符串长度计算、大小写转换、拼接字符串、替换、剔除、查找字符所在位置、前后缀匹配等。

str_exist 函数

函数定义

在值中指定范围内查找子串，返回 True 或 False。

语法描述

str_exist(data1, data2, ignore_upper=False)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data1
字符串类型的值
string
是
-
-
data2
字符串类型的值
string
是
-
-
ignore_upper
是否区分大小写
Bool
否
False
-

示例

原始日志：
{"data": "cls nihao"}
加工规则：
fields_set("result", str_exist(v(data), "nihao"))
加工结果：
{"result":"true","data":"cls nihao"}

str_count 函数

函数定义

在值中指定范围内查找子串，返回子串出现的次数。

语法描述

str_count(值, sub="", start=0, end=-1)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
sub
准备查找的子字符串
string
是
-
-
start
查找的起始位置
number
否
默认为0
-
end
查找的结束位置
number
否
默认为-1
-

示例

原始日志：
{"data": "warn,error,error"}
加工规则：
fields_set("result", str_count(v("data"), sub="err"))
加工结果：
{"result":"2","data":"warn,error,error"}

str_len 函数

函数定义

返回字符串长度。

语法描述

str_len(值)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-

示例

原始日志：
{"data": "warn,error,error"}
加工规则：
fields_set("result", str_len(v("data")))
加工结果：
{"result":"16","data":"warn,error,error"}

str_uppercase 函数

函数定义

返回大写字符串。

语法描述

str_uppercase(值)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-

示例

原始日志：
{"data": "warn,error,error"}
加工规则：
fields_set("result", str_uppercase(v("data")))
加工结果：
{"result":"WARN,ERROR,ERROR","data":"warn,error,error"}

str_lowercase 函数

函数定义

返回小写字符串。

语法描述

str_lowercase(值)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-

示例

原始日志：
fields_set("result", str_lowercase(v("data")))
加工规则：
{"data": "WARN,ERROR,ERROR"}
加工结果：
{"result":"warn,error,error","data":"WARN,ERROR,ERROR"}

str_join 函数

函数定义

使用拼接字符串，拼接多值。

语法描述

str_join(拼接字符串1, 值1, 值2, ...)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
join
字符串类型的值
string
是
-
-
值参数，可变参数列表
字符串类型的值
string
是
-
-

示例

原始日志：
{"data": "WARN,ERROR,ERROR"}
加工规则：
fields_set("result", str_join(",", v("data"), "INFO"))
加工结果：
{"result":"WARN,ERROR,ERROR,INFO","data":"WARN,ERROR,ERROR"}

str_replace 函数

函数定义

替换字符串，返回替换结果字符串。

语法描述

str_replace(值, old="", new="", count=0)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
old
将要被替换的字符串
string
是
-
-
new
替换的目标字符串
string
是
-
-
count
最大替换次数，默认全部替换
number
否
默认为0
-

示例

将字段 data 的值中的 "WARN" 替换为 "ERROR"。
原始日志：
{"data": "WARN,ERROR,ERROR"}
加工规则：
fields_set("result", str_replace( v("data"), old="WARN", new="ERROR"))
将替换的结果保存到新字段 "result" 中。 加工结果：
{"result":"ERROR,ERROR,ERROR","data":"WARN,ERROR,ERROR"}

str_format 函数

函数定义

格式化字符串，返回格式化结果。

语法描述

str_format(格式化字符串, 值1, 值2, ...)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
format
目标格式，占位符使用{}，其中{}中的数字，对应后面参数值的序号，从0开始。具体使用可参考 MessageFormat.format 函数的使用
string
是
-
-
值参数，可变参数列表
字符串类型的值
string
是
-
-

示例

原始日志：
{"status": 200, "message":"OK"}
加工规则：
fields_set("result", str_format("status:{0}, message:{1}", v("status"), v("message")))
加工结果：
{"result":"status:200, message:OK","message":"OK","status":"200"}

str_strip 函数

函数定义

剔除用户指定的字符序列中的字符，从字符串开头和结尾同时剔除，返回剔除后的结果。

语法描述

str_strip(值, chars="\\t\\r\\n")

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
chars
将要被剔除的字符序串
string
否
\\t\\r\\n
-

示例

示例1
原始日志：
{"data": " abc  "}
加工规则：
fields_set("result", str_strip(v("data"), chars=" "))
加工结果：
{"result":"abc","data":" abc  "}
示例2
原始日志：
{"data": " **abc**  "}
加工规则：
fields_set("result", str_strip(v("data"), chars=" *"))
加工结果：
{"result":"abc","data":" **abc**  "}

str_lstrip 函数

函数定义

剔除用户指定的字符序列中的字符，从字符串左侧开头剔除，返回剔除后的结果。

语法描述

str_strip(值, chars="\\t\\r\\n")

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
chars
将要被剔除的字符序串
string
否
\\t\\r\\n
-

示例

原始日志：
{"data": " abc  "}
加工规则：
fields_set("result", str_lstrip(v("data"), chars=" "))
加工结果：
{"result":"abc  ","data":" abc  "}

str_rstrip 函数

函数定义

剔除用户指定的字符序列中的字符，从字符串右侧结尾部分剔除，返回剔除后的结果。

语法描述

str_strip(值, chars="\\t\\r\\n")

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
chars
将要被剔除的字符序串
string
否
\\t\\r\\n
-

示例

原始日志：
{"data": " abc  "}
加工规则：
fields_set("result", str_rstrip(v("data"), chars=" "))
加工结果：
{"result":" abc","data":" abc  "}

str_find 函数

函数定义

在值中查找子串，并返回子串出现的位置。

语法描述

str_find(值, sub="", start=0, end=-1)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
sub
准备查找的子字符串
string
是
-
-
start
查找的起始位置
number
否
默认为0
-
end
查找的结束位置
number
否
默认为-1
-

示例

原始日志：
{"data": "warn,error,error"}
加工规则：
fields_set("result", str_find(v("data"), sub="err"))
加工结果：
{"result":"5","data":"warn,error,error"}

str_start_with 函数

函数定义

判断字符串是否以指定前缀开头。

语法描述

str_start_with(值, sub="", start=0, end=-1)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
sub
前缀字符串或字符
string
是
-
-
start
查找的起始位置
number
否
默认为0
-
end
查找的结束位置
number
否
默认为-1
-

示例

示例1
原始日志：
{"data": "something"}
加工规则：
fields_set("result", str_start_with(v("data"), sub="some"))
加工结果：
{"result":"true","data":"something"}
示例2
原始日志：
{"data": "something"}
加工规则：
fields_set("result", str_start_with(v("data"), sub="*"))
加工结果：
{"result":"false","data":"something"}

str_end_with 函数

函数定义

判断字符串是否以指定前缀开头。

语法描述

str_end_with(值, sub="", start=0, end=-1)

参数说明

参数名称
参数描述
参数类型
是否必须
参数默认值
参数取值范围
data
字符串类型的值
string
是
-
-
sub
前缀字符串或字符
string
是
-
-
start
查找的起始位置
number
否
默认为0
-
end
查找的结束位置
number
否
默认为-1
-

示例

原始日志：
{"data": "endwith something"}
加工规则：
fields_set("result", str_end_with(v("data"), sub="ing"))
加工结果：
{"result":"true","data":"endwith something"}

上一篇: 时间值处理函数下一篇: 类型转换函数

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈