output() Function (Python, SLAX, and XSLT)
命名空间
http://xml.juniper.net/junos/commit-scripts/1.0 http://xml.libslax.org/slax
Python 语法
jcs.output(string, <string>)
SLAX 语法
expr prefix:output(string, <string>);
XSLT 语法
<xsl:value-of select="prefix:output(string, <string>)"/>
描述
在 CLI 上(在 op 脚本中使用时)或输出文件(在事件脚本中使用时)上显示一行或多行输出文本。脚本可以使用单个字符串参数或多个字符串参数调用函数。多个参数串联成一个字符串。换行符终止输出文本。
提交脚本不支持该 output() 函数。SLAX 和 XSLT 提交脚本使用 <xnm:warning> 和 <xnm:error> 结果树元素在 CLI 上显示文本。Python 提交脚本使用 emit_warning() 和 emit_error() 函数。
该 output() 函数立即显示文本,而不是等到脚本结束,这与 SLAX 和 XSLT <output> 元素不同。这使得它适用于需要用户交互或需要在执行过程中显示状态消息的脚本。在 SLAX 和 XSLT 脚本中, jcs:output() 返回一个空节点集,可以忽略该节点集。因此,通常使用 expr 语句来调用 jcs:output() 函数,而不是将其结果分配给变量。
输出文本中支持以下转义字符:
-
\\–反斜線
-
\r –回车
-
\“ –双引号
-
\n –换行符
-
\' – 单引号
-
\t –制表符
输出文本的最大长度为 10 KB,较长的字符串将被截断为支持的长度。
prefix应在样式表的前缀到命名空间的映射中定义与命名空间 URI 关联的内容。
参数
string |
立即输出到 CLI 会话的文本。 |
使用示例
Python 语法:
jcs.output('The VPN is up.')
SLAX 语法:
expr jcs:output('The VPN is up.');
XSLT 语法:
<xsl:value-of select="jcs:output('The VPN is up.')"/>
发布信息
在 Junos OS 7.6 版中引入的功能。
Junos OS 12.2 版中添加了对 slax 命名空间 http://xml.libslax.org/slax 支持。
在 Junos OS 16.1R1 版中添加了对 Python 的支持。