1 宏函数
概述
宏函数能提供自定义宏值的功能。
有时宏可能会解析为一个不一定易于使用的值。它可能很长，或包含你想提取的一个特殊感兴趣的子字符串。这在宏函数中是可以使用的。
宏函数的语法为：
其中：
- <macro> - 这个参数为要定义的宏 （例如 {ITEM.VALUE}）；
- <func> - 要应用的函数；
- <params> - 以逗号分隔的函数参数列表。如果他们以'' '' (空格),
"或者包含),,这些符号开始，则参数必须要引用。
例如：
受支持的宏函数
| 函数 | ||||
|---|---|---|---|---|
| 描述 * | 参数** **受 | 持于** | ||
| regsub (<pattern>,<output>) | ||||
| 通过正则表达式匹配提取的子字符串（区分大小写）。 pattern - 匹配的正则表达式 |
{ITEM.VALUE} output - 输出的选项。 \1 - \9 占位符支持被正则表达式匹配的组placeholders are supported for captured groups. {ITEM.LASTVALUE} 如果参数 pattern 是一个不正确的正则表达式，那么将返回 “UNKNOWN” 。 |
|||
| iregsub (<pattern>,<output>) | ||||
| 通过正则表达式匹配提取的子字符串（区分大小写）。 pattern - 匹配的正则表达式 |
{ITEM.VALUE} output - 输出得选项 \1 - \9 placeholders are supported for captured groups {ITE 如果参数 pattern 是一个不正确的正则表达式，那么将返回 “UNKNOWN” 。 |
<.LASTVALUE} | ||
如果在受支持的位置使用函数，但是应用于不支持宏函数得宏， 那么宏的计算结果为 “UNKNOWN”。
如果在不支持宏函数的位置将宏函数应用于宏， 则忽略该函数。
示例
关于宏函数可用于自定义宏值的方法，在下面的示例中说明，其中包含的 “log line” 作为接收值：
| 接收值 宏 | 输出 | |
|---|---|---|
123Log line |
{{ITEM.VALUE}.regsub(^[0-9]+, Problem)} |
Problem |
123 Log line |
{{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")} |
Problem |
123 Log line |
{{ITEM.VALUE}.regsub("^([0-9]+)", Problem ID: \1)} |
Problem ID: 123 |
Log line |
{{ITEM.VALUE}.regsub(".*", "Problem ID: \1")} |
''Problem ID: '' |
MySQL crashed errno 123 |
{{ITEM.VALUE}.regsub("^([A-Z]+).*([0-9]+)", " Problem ID: \1_\2 ")} |
'' Problem ID: MySQL_123'' |
123 Log line |
{{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")} |
*UNKNOWN* (invalid regular expression) |