9 字符串函数
此处列出的所有功能均受支持：
下面列出的函数没有附加信息。点击该函数查看完整的详细信息。
| 函数 | 说明 |
|---|---|
| ascii | 值最左边字符的ASCII码。 |
| bitlength | 以比特为单位值的长度。 |
| bytelength | 以字节为单位值的长度。 |
| char | 通过将值转换为ASCII码来返回字符。 |
| concat | 由串联引用的监控项值或常量值产生的字符串。 |
| insert | 从字符串中的指定位置开始，将指定的字符或空格插入到字符串中。 |
| jsonpath | 返回JSONPath结果。 |
| left | 返回值最左边的字符。 |
| length | 以字符为单位值的长度。 |
| ltrim | 从字符串的开头删除指定的字符。 |
| mid | 返回从'start'指定的字符位置开始的N个字符的子字符串。 |
| repeat | 重复字符串。 |
| replace | 在值中查找样例值并用替换值进行替换。 |
| right | 返回值最右边的字符。 |
| rtrim | 从字符串的末尾删除指定的字符。 |
| trim | 从字符串的开头和结尾删除指定的字符。 |
| xmlxpath | 返回XML路径语言结果。 |
函数详情
关于函数参数的一般性说明：
- 函数参数用逗号分隔
- 表达式可以作为参数
- 字符串参数必须用双引号括起来；否则可能会被误解
- 可选函数参数（或参数部分）由
<>表示
ascii(value)
值最左边字符的ASCII码。
支持的值类型：字符串、文本、日志。
参数：
- value - 要检查的值
例如，'Abc'这样的值将返回'65'（'A'的ASCII代码）。
示例：
bitlength(value)
以比特为单位值的长度。
支持的值类型：字符串、文本、日志、整数。
参数：
- value - 要检查的值
示例：
bytelength(value)
以字节为单位值的长度。
支持的值类型：字符串、文本、日志、整数。
参数：
- value - 要检查的值
示例：
char(value)
通过将值转换为ASCII码来返回字符。
支持的值类型：整数。
参数：
- value - 要检查的值
该值必须在0-255范围内。例如，'65'这样的值（解释为ASCII码）将返回'A'。
示例：
concat(<value1>,<value2>,...)
由串联引用的监控项值或常量值产生的字符串。
支持的值类型：字符串、文本、日志、浮点、整数。
参数：
- valueX -由历史函数之一返回的值或常量值（字符串、整数或浮点数）。必须至少包含两个参数。
例如，'Zab'这样的值连接到'bix'（常量字符串）将返回'Zabbix'。
示例：
concat(last(/host/key),"bix")
concat("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15]))insert(value,start,length,replacement)
从字符串中的指定位置开始，将指定的字符或空格插入到字符串中。
支持的值类型：字符串、文本、日志。
参数：
- value - 要检查的值；
- start - 开始的位置；
- length - 要替换的位置；
- replacement - 替换的字符串。
例如，如果将 'bb'（起始位置 3，要替换的位置 2）替换为 'b'，则类似于 'Zabbbix' 的值将替换为 'Zabbix'。
示例：
jsonpath(value,path,<default>)
返回JSONPath结果。
支持的值类型：字符串、文本、日志。
参数：
- value - 要检查的值；
- path - 路径（必须加引号）;
- default - 如果JSONPath查询没有数据返回，则为可选的回退值。请注意，在其他错误中会返回失败 （比如"不支持的结构"）。
示例：
left(值,count)
返回值中最左边的字符。
支持的值类型：字符串, 文本, 日志。
参数：
- 值 - 要检查的值；
- 数量 - 要返回的字符数。
例如，通过指定返回最左边的3个字符，可以从'Zabbix'中返回'Zab'。另请参阅 right()。
示例：
length(value)
以字符为单位值的长度。
支持的值类型：字符串、文本、日志。
参数：
- value - 要检查的值
示例：
length(last(/host/key)) #the length of the latest value
length(last(/host/key,#3)) #the length of the third most recent value
length(last(/host/key,#1:now-1d)) #the length of the most recent value one day agoltrim(值,<字符>)
从字符串的开头移除指定的字符。
支持的值类型：字符串, 文本, 日志。
参数:
- 值 - 要检查的值;
- 字符（可选）- 指定要移除的字符。
默认情况下，空白字符将从左边移除（如果没有指定可选字符）。另请参阅：rtrim(), trim()。
示例：
ltrim(last(/主机/键)) #从字符串开头移除空白字符
ltrim(last(/主机/键),"Z") #从字符串开头移除任何 'Z'
ltrim(last(/主机/键)," Z") #从字符串开头移除任何空格和 'Z'mid(值,start,长度)
返回从由'start'指定的字符位置开始的N个字符的子字符串。
支持的值类型：字符串, 文本, 日志。
参数：
- 值 - 要检查的值；
- start - 子字符串的起始位置；
- 长度 - 子字符串中要返回的位置数。
例如，如果起始位置是2，并且要返回的位置数是4，那么可以从类似'Zabbix'的值中返回'abbi'。
示例：
重复(value,次数)
重复一个字符串。
支持的值类型：字符串, 文本, 日志。
参数：
- value - 要检查的值；
- 次数 - 重复的次数。
示例：
replace(值,模式,替换)
在值中查找模式并用替换替换。模式的所有出现都将被替换。
支持的值类型：字符串, 文本, 日志。
参数：
- 值 - 要检查的值；
- 模式 - 要查找的模式；
- 替换 - 用于替换模式的字符串。
示例：
right(值,计数)
返回值最右侧的字符。
支持的值类型：字符串, 文本, 日志。
参数：
- 值 - 要检查的值；
- 计数 - 要返回的字符数量。
例如，通过指定返回最右侧的3个字符，可以从'Zabbix'中返回'bix'。另请参阅 left()。
示例：
rtrim(值,<字符>)
从字符串的末尾移除指定的字符。
支持的值类型：字符串, 文本, 日志。
参数:
- 值 - 要检查的值;
- 字符（可选）- 指定要移除的字符。
默认情况下，会从右侧移除空白字符（如果没有指定可选字符）。另请参阅：ltrim(), trim()。
示例：
rtrim(last(/主机/键)) #从字符串末尾移除空白字符
rtrim(last(/主机/键),"x") #从字符串末尾移除任何 'x'
rtrim(last(/主机/键),"x ") #从字符串末尾移除任何 'x' 和空格trim(值,<字符>)
从字符串的开头和结尾移除指定的字符。
支持的值类型：字符串, 文本, 日志。
参数:
- 值 - 要检查的值;
- 字符（可选） - 指定要移除的字符。
默认情况下，从两边移除空白字符（如果没有指定可选字符）。另请参阅：ltrim(), rtrim()。
示例:
xmlxpath(value,path,<default>)
返回XML路径语言结果。
支持的值类型：字符串、文本、日志。
参数：
- value - 要检查的值；
- path - 路径（必须加引号）;
- default - 如果XML XPath查询返回空节点集，这是可选的回退值。 如果空结果不是节点集（即空字符串）则不返回。在其他错误中，会返回失败（例如 "无效表达式"）。
示例：
参见 所有支持的函数。