宏函数能提供自定义宏值的功能。
有时候宏可能会解析为一个不一定易于使用的值。它可能很长,或包含你想提取的一个特殊感兴趣的子字符串。这在宏函数中是可以使用的。
宏函数的语法为:
其中:
"
或者包含 )
, ,
这些符号开始,则参数必须要引用。例如:
函数 | ||||
---|---|---|---|---|
描述 * | 参数** **受 | 持于** | ||
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) |