arc:equals

Version 22.0.8473


arc:equals

Version 22.0.8473


The arc:equals keyword compares the value of an attribute to a reference value. Unlike arc:check, the arc:equals keyword will throw an exception if the specified item does not contain the specified attribute. If the specified attribute exists and its value matches, then the comparison will succeed.

Note: Both arc:equals and arc:check expect the name of the attribute whose value will be compared with a given value. If you need to compare two values, you can use arc:select instead. For example:

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

Parameters

  • item: The item in which to compare the attribute. Specifying an item is not required. If no item is specified, the default output item is used instead.
  • attr: The name of the attribute to compare.
  • case: Whether to use case-sensitive or case-insensitive comparison. This defaults to case-sensitive comparison; to use case-insensitive comparison, set the case parameter to “ignore”.
  • value: The value to compare the attribute with.
  • action: The action to perform if equality is met. Allowed values: break, continue.

Control Attributes

None

Example

Like other conditional keywords, the body of arc:equals may also contain an arc:else keyword, which will be executed if the values do not match. The following lists all files except .err files:

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

See Also

  • arc:select: Choose between more than one alternative.
  • arc:notequals: Create a block that is executed when equality is not met.