1 宏函数

概述

宏函数能提供自定义宏值的功能。

有时候宏可能会解析为一个不一定易于使用的值。它可能很长，或包含你想提取的一个特殊感兴趣的子字符串。这在宏函数中是可以使用的。

宏函数的语法为：

  1. {<macro>.<func>(<params>)}

其中：

  • - 这个参数为要定义的宏 （例如 {ITEM.VALUE}）；

  • - 要应用的函数；

  • - 以逗号分隔的函数参数列表。如果他们以 (空格), " 或者包含 ), ,这些符号开始，则参数必须要引用。

    例如： 

  1. {{ITEM.VALUE}.regsub(pattern, output)}

受支持的宏函数

函数
描述参数受支持于
regsub (<pattern>,<output>)
通过正则表达式匹配提取的子字符串（区分大小写）。 pattern - 匹配的正则表达式output - 输出的选项。 \1 - \9 占位符支持被正则表达式匹配的组placeholders are supported for captured groups. 如果参数 pattern 是一个不正确的正则表达式，那么将返回 “UNKNOWN” 。 {ITEM.VALUE}{ITEM.LASTVALUE}
iregsub (<pattern>,<output>)
通过正则表达式匹配提取的子字符串（区分大小写）。 pattern - 匹配的正则表达式output - 输出得选项 \1 - \9 placeholders are supported for captured groups如果参数 pattern 是一个不正确的正则表达式，那么将返回 “UNKNOWN” 。 {ITEM.VALUE}{ITEM.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)