arc:check キーワードは、value パラメータの有無にかかわらず使用します。値パラメータがない場合は、arc:check のボディが実行される前に、アトリビュートがアイテムの中に存在しnull 文字列ではないことを確認します。
値パラメータを指定した場合は、arc:check ボディはエクスプレッションがtrue と評価された場合のみ実行します。他の値はfalse となります。評価では、大文字と小文字を区別しません。
他のScript のシンプルな条件文と同様に、arc:check はarc:else キーワードとペアで使うことができます。
arc:equals とは異なり、
arc:check はアイテムにアトリビュートが存在しない場合でも例外をスローしません。パラメータ
- item:アトリビュートをチェックするアイテム。アイテムの指定は必須ではありません。アイテムが指定されていない場合は、デフォルトのアウトプットアイテムが使われます。
- attr:チェックするアトリビュートの名前。このパラメータは必須です。
- value:
trueまたはfalseと評価されるエクスプレッション。例えば、true もしくはfalse を返すフォーマッタの結果です。 - action:エクスプレッションが
trueと判断された場合に実行されるアクション。使用できる値は、breakおよびcontinueです。
アトリビュートの制御
None例
アイテムにアトリビュートがあるかどうかをチェックする この例は、arc:check を使用して、result アイテムにnumber アトリビュートが存在するかどうかを確認します。true の場合、メッセージにヘッダーが追加されます。そうでない場合は、エラーが発生します。
arc:check を使用して反復値を確認します。5に等しい場合は、列挙を終了します。値が5に等しくない場合は、データを含むファイルを作成し、そのファイルを出力としてプッシュします。
関連項目
- arc:exists:アトリビュートが存在するかどうかをチェックする。
- arc:equals:同じ値かどうかをチェックする。
- arc:notequals:同じ値ではないかどうかをチェックする。