api:equals
Version 25.3.9411
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:等しい場合に実行するアクション。使用できる値は、
break、continueです。
アトリビュートの制御
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:同じ値ではない場合に実行されるブロックを作成する。