api:equals

Version 25.3.9411


api:equals


api:equals キーワードを使用して、アトリビュートの値と参照値を比較します。api:check とは異なり、api:equals は指定されたアイテムが指定されたアトリビュートを含まない場合、例外をスローします。指定されたアトリビュートが存在し、その値が一致する場合、比較が成功します。

Note:api:equals およびapi:check はどちらも、与えられた値と比較される値を持つアトリビュート名を求めます。2つの値を比較するには、代わりにapi:select を使用します。次に例を示します:

<api:select value="[company_name]">
  <api:case value="CompanyA">
    <img src="http://www.companya.com/favicon.ico" />
  </api:case>
  <api:case value="CompanyB">
    <img src="http://www.companyb.com/favicon.ico" />
  </api:case>
  <api:default>
    <img src="http://www.myhosting.com/generic.ico"/>
  </api:default>
</api:select>

パラメータ

  • item:アトリビュートを比較するアイテム。アイテムが指定されていない場合は、デフォルトのアウトプットアイテムが使われます。
  • attr:比較するアトリビュートの名前。
  • case:比較で大文字-小文字を区別するかどうか。デフォルトは大文字-小文字を区別します。大文字-小文字を区別しない場合には、これをignore に設定します。
  • value:アトリビュートを比較する値。
  • action:等しい場合に実行するアクション。使用できる値は、breakcontinue です。

アトリビュートの制御

None

他の条件キーワードと同様に、api:equals のボディは、api:else キーワードを含むことがあり、値が一致しない場合に実行されます。この例は、.err ファイルを除くすべてのファイルをリストします:

<api:call op="fileListDir">
  <api:equals attr="file:extension" value=".err">
  <api:else>
    <api:push/>
  </api:else>
  </api:equals>
</api:call>

関連項目

  • api:select:2つ以上の選択肢から選択する。
  • api:notequals:同じ値ではない場合に実行されるブロックを作成する。