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スクリプトで使用されている場合)または出力ファイル(イベントスクリプトで使用されている場合)のいずれかで、1つ以上の出力テキスト行を表示します。この関数は、単一の文字列引数または複数の文字列引数を使用して呼び出すことができます。複数の引数が 1 つの文字列に連結されます。改行は、出力テキストを終了します。
このoutput()
関数は、コミット スクリプトではサポートされていません。SLAX および XSLT コミット スクリプトは、 および <xnm:error>
の結果ツリー要素を使用<xnm:warning>
して CLI にテキストを表示し、Python コミット スクリプトでは、 および emit_error()
関数をemit_warning()
使用します。
この関数は output()
、SLAX および XSLT <output>
要素とは異なるスクリプトの終了まで待機するのではなく、テキストをすぐに表示します。これにより、ユーザーの操作が必要なスクリプトや、スクリプト処理中にステータス メッセージを表示する必要がある場合に適しています。SLAX および XSLT スクリプトでは、 jcs:output()
空のノード セットを返します。これは無視できます。したがって、 jcs:output()
関数は通常、その結果を expr
変数に割り当てるのではなく、 ステートメントで呼び出されます。
出力テキストでは、以下のエスケープ文字がサポートされています。
\\ – バックスラッシュ(Junos OS リリース 10.2 時点)
\r – キャリッジ・リターン
\" – 二重引用符(Junos OS リリース 10.1R2 時点)
\n - 改行
\' – 一重引用符
\t – タブ
Junos OS リリース 10.2 以降、出力テキストの最大長は 10 KB で、長い文字列はサポートされている長さに切り捨てられます。
prefix名前空間 URI に関連付けられているものは、スタイル シートのプレフィックスから名前空間へのマッピングで定義する必要があります。
パラメーター
string |
CLI セッションに直ちに出力されるテキスト。 |
使用例
SLAX構文:
expr jcs:output('The VPN is up.');
XSLT 構文:
<xsl:value-of select="jcs:output('The VPN is up.')"/>
Python 構文:
jcs.output('The VPN is up.')
リリース情報
Junos OS リリース 7.6 で導入された機能。
Junos OS リリース 12.2 で追加 http://xml.libslax.org/slax slax 名前空間のサポート。
QFX シリーズ スイッチと ACX シリーズ、MX シリーズ、PTX シリーズ、T Series ルーターの Junos OS リリース 16.1R1 で追加された Python のサポート。
ACX500、ACX1000、ACX1100、ACX2000、ACX2100、ACX2200、ACX4000 ルーター、EX シリーズ スイッチで Junos OS リリース 17.1R1 に追加された Python のサポート。
SRX1500、SRX4100、SRX4200、SRX5400、SRX5600、SRX5800 デバイスおよび vSRX インスタンスで Junos OS リリース 17.3R1 に追加された Python のサポート。
ACX5048およびACX5096ルーターのJunos OSリリース18.3R1で追加されたPythonのサポート。