> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arc.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# arc:equals

> アトリビュートの値と参照値を比較し、一致する場合にボディブロックを実行します。アトリビュートが存在しない場合は例外をスローします。

export const siteNameShort = "Arc";

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

<Note>
  `arc:equals` および`arc:check` はどちらも、与えられた値と比較される値を持つアトリビュート名を求めます。2つの値を比較するには、代わりに[arc:select](./op-arc-select) を使用できます。次に例を示します：

  ```xml theme={null}
  <arc:select value="[company_name]">
    <arc:case value="CompanyA">
      <img src="http://www.companya.com/favicon.ico" />
    </arc:case>
    <arc:case value="CompanyB">
      <img src="http://www.companyb.com/favicon.ico" />
    </arc:case>
    <arc:default>
      <img src="http://www.myhosting.com/generic.ico"/>
    </arc:default>
  </arc:select>
  ```
</Note>

## パラメータ

* **item**：アトリビュートを比較するアイテム。アイテムの指定は必須ではありません。アイテムが指定されていない場合は、デフォルトアイテムが使われます。
* **attr**：比較するアトリビュートの名前。
* **case**：比較で大文字-小文字を区別するかどうか。デフォルトは大文字-小文字を区別します。大文字-小文字を区別しない場合には、このパラメータを`ignore` に設定します。
* **value**：アトリビュートを比較する値。
* **action**：等しい場合に実行するアクション。使用できる値は、`break` または`continue` です。

## アトリビュートの制御

None

## 例

他の条件キーワードと同様に、`arc:equals` のボディは、[arc:else](./op-arc-else) キーワードを含むことがあり、値が一致しない場合に実行されます。以下は、`.err` ファイルを除くすべてのファイルをリストします：

```xml theme={null}
<arc:call op="fileListDir">
  <arc:equals attr="file:extension" value=".err">
  <arc:else>
    <arc:push/>
  </arc:else>
  </arc:equals>
</arc:call>
```

## 関連項目

* [arc:select](./op-arc-select)：2つ以上の選択肢から選択する。
* [arc:notequals](./op-arc-not-equals)：同じ値ではない場合に実行されるブロックを作成する。