Provide Macro as Log Value

概要

この演算子は、指定されたマクロの値を読み取り、ロギング用のマクロ値を提供します。この演算子は、必要なマクロ値を直接記録できない場合にのみ役立ちます。

詳細

「マクロをログ値として提供」演算子を使用して、指定したマクロの現在の値をログに記録できます。必要なマクロの名前は、 マクロ名パラメーターで指定されます。ほとんどの演算子は、ログ可能な値として定義するマクロを提供します。これらの場合、この値は直接ログに記録できます。ただし、定義されたマクロのログ可能な値をオペレーターが提供しない他のすべての場合、このオペレーターを使用してそうすることができます。値は実際には数値であっても、名目値として記録されることに注意してください。

この演算子を完全に理解するには、マクロとロギングの基本概念に精通している必要があります。マクロとロギングのいくつかの基本については、次の段落で説明します。

マクロは、マクロが定義された後に来る現在のプロセスのすべてのオペレーターが使用できる値と見なすことができます。マクロが定義されると、 ％{macro_name}形式のマクロ名を「macro_name」がマクロの名前であるパラメーター値に書き込むことにより、そのマクロの値を次の演算子のパラメーター値として使用できます。多くのループ演算子（ループ値、ループ属性など）のような多くの演算子も特定のマクロを追加することに注意してください。マクロに関する詳細については、マクロの設定演算子をご覧ください。

ロギングおよびログ関連の演算子は、情報をログテーブルに保存します。この情報は、オペレーターのパラメーター値、オペレーターの適用回数、実行時間など、ほとんど何でもかまいません。ログは、通常は表示されないプロセスの実行中に計算された値を見たいときに使用されます。たとえば、ループ演算子のすべての反復で異なるパラメーターの値を表示したい場合。ロギングの詳細については、Logオペレーターをご覧ください。

入力

スルー（IOObject）このポートにオブジェクトを接続することは必須ではありません。このポートで接続されたオブジェクトは、出力ポートを変更せずに配信されます。この演算子は複数の入力を持つことができます。ある入力が接続されると、別の入力（ある場合）を受け入れる準備ができている別の入力ポートを介して使用可能になります。入力の順序は同じままです。「マクロをログ値として提供」演算子の最初の入力ポートで提供されたオブジェクトは、最初の出力ポートで使用可能です。

出力

スルー（IOObject）入力として与えられたオブジェクトは、このポートを介して出力に変更されることなく渡されます。このポートを他のポートに接続することは必須ではありません。ログ値としてマクロを提供演算子には、複数の出力を含めることができます。 1つの出力が接続されると、出力ポートを介して別の出力が使用可能になり、別の出力（ある場合）を配信する準備が整います。出力の順序は同じままです。ログ値としてマクロを提供演算子の最初の入力ポートから配信されるオブジェクトは、最初の出力ポートから配信されます

パラメーター

macro_nameこのパラメーターは、ログに値を提供するマクロの名前を指定します。範囲：文字列

チュートリアルプロセス

マクロをログ値として提供する演算子を使用して、または使用せずにマクロの値を記録

このプロセス例は、マクロ値を「ログ値としてマクロを提供」演算子を使用して、または使用せずに記録する方法を示しています。「ゴルフ」データセットは、検索演算子を使用してロードされます。 ExampleSetを見ることができるように、ブレークポイントがここに挿入されます。ご覧のとおり、ExampleSetには14の例があります。マクロの抽出演算子は、ExampleSetに適用されます。抽出マクロ演算子のマクロには「eCount」という名前が付けられ、ExampleSetに例の数、つまり14が格納されます。「マクロをログ値として提供」演算子を適用して、「eCount」マクロの値をログ可能な値として提供します最後に、Logテーブルに「eCount」マクロの値を保存するためにLog演算子が適用されます。 Logオペレーターのログパラメーター設定をご覧ください。「直接」と「間接」の2つの列が定義されています。「直接」列は、マクロの抽出演算子から「eCount」マクロの値を直接取得します。これは、オペレーターがログ可能な形式でマクロを提供する場合にのみ機能します。「間接」列は、「ログ値としてマクロを提供」演算子から「eCount」マクロの値を取得します。これは、マクロ値を直接記録できない場合に記録する方法です。プロセスを実行すると、ログオペレーターの結果のテーブルビューに2つの列が表示されます。両方の列に「eCount」マクロの値があります（14）。