4.4.3 変数存在テスト("variable")
説明
変数存在テスト(コード"variable")は、実際の画像比較アルゴリズムではありません。これは、workitem内で並行して実行されるスクリプト間の通信を可能にするために、セッション変数の出現または消滅を待つWaitForコマンドの仕組みを利用しているだけです。
この仕組みは、プロデューサー・コンシューマーのシナリオを実装するために使用できます:
-
一方のスクリプト(「プロデューサー」)がタスクを実行し、Vargコマンドを通じてセッション変数を作成した後、その変数が消えるまでWaitfor mismatchを使用してサスペンドします。
-
並行して実行されているもう一方のスクリプト(「コンシューマー」)は、その変数が作成されたこと(Waitfor match)を検知してタスクを実行し、ジョブの完了を最初のスクリプトに通知するためにVargを使用してその変数を削除します。
オプション
"name"パラメーターは変数名を指定します。
"passrate"パラメーターは互換性のためだけに受け付けられますが、指定しても無視されます。
戻り値
このメソッドは、変数が存在する場合、呼び出し元のコマンド(メソッド呼び出し)に0(成功)を返させます。存在しない場合は、1を返します。
使用例
Waitfor match method="variable" name="FLAG" timeout="5m"
if ({_EXIT_CODE} > 0) {
Exit 1 desc="The other script failed to populate the FLAG variable within the timeout of 5 minutes!"
}
- 別のスクリプトがFLAGというセッション変数を作成するのを待ちます。5分以内にその変数が現れない場合はスクリプトを終了します。