1 宏函数

1 Macro functions

概述

Overview

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

Macro functions offer the ability to customize macro values.

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

Sometimes a macro may resolve to a value that is not necessarily easy to work with. It may be long or contain a specific substring of interest that you would like to extract. This is where macro functions can be useful.

宏函数的语法为：

The syntax of a macro function is:

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

其中：

where:

• <macro> - 这个参数为要定义的宏 （例如 {ITEM.VALUE}）；
• <func> - 要应用的函数；
• <params> - 以逗号分隔的函数参数列表。如果他们以'' '' (空格), " 或者包含 ), ,这些符号开始，则参数必须要引用。

• <macro> - the macro to customize (for example {ITEM.VALUE})
• <func> - the function to apply
• <params> - a comma-delimited list of function parameters. Parameters must be quoted if they start with '' '' (space), " or contain ), ,.

例如：

For example:

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

受支持的宏函数

Supported macro functions

如果在受支持的位置使用函数，但是应用于不支持宏函数得宏， 那么宏的计算结果为 “UNKNOWN”。

If a function is used in a supported location, but applied to a macro not supporting macro functions, then the macro evaluates to 'UNKNOWN'.

如果在不支持宏函数的位置将宏函数应用于宏， 则忽略该函数。

If a macro function is applied to the macro in locations not supporting macro functions then the function is ignored.

示例

Examples

关于宏函数可用于自定义宏值的方法，在下面的示例中说明，其中包含的 “log line” 作为接收值：

The ways in which macro functions can be used to customize macro values is illustrated in the following examples containing log lines as received value: