arc:equals - 知行之桥文档

arc:equals 關鍵字可以將屬性的值與一個參考值進行比較。和 arc:check 不同，arc:equals 關鍵字將會在指定的物件沒有包含指定的屬性時擲回例外。如果指定的屬性存在且值也匹配，那麼比較就是成功的。

arc:equals 和 arc:check 都需要屬性的名稱，該屬性的值將會與給定的值進行比較。如果需要比較兩個值，可以使用 arc:select。例如：

<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>

參數

item：用於比較屬性的物件。指定物件不是必需的。如果未指定物件，則使用預設輸出物件。
attr：要比較的屬性的名稱。
case：比較時是否忽略大小寫。預設為大小寫敏感；要忽略大小寫，將 case 參數設為 “ignore”。
value：與屬性比較的值。
action：如果相等將執行的操作。允許的值有：break，continue。

控制屬性

無

範例

和其它條件的關鍵字一樣，arc:equals 關鍵字主體也可以也包含 arc:else 關鍵字，如果值不匹配時將會執行 else 程式碼塊。下面的範例列出了除了 .err 檔案之外的所有檔案：

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

另請參閱

arc:select：在多個情況中選擇。
arc:notequals：建立一個不滿足相等條件時執行的程式碼塊。