Search

arc:equals

Version 24.2.9039

arc:equals

Use the arc:equals keyword to compare the value of an attribute to a reference value. Unlike arc:check, arc:equals throws an exception if the specified item does not contain the specified attribute. If the specified attribute exists and its value matches, the comparison succeeds.

Note: arc:equals and arc:check both expect the name of the attribute whose value should be compared with a given value. 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 item is not specified, the default item is used.
  • attr: The name of the attribute to compare.
  • case: Whether to use case-sensitive or case-insensitive comparison. The default is case-sensitive comparison; to use case-insensitive comparison, set this parameter to ignore.
  • value: The value to compare the attribute with.
  • action: The action to perform if equality is met. Allowed values: break or continue.

Control Attributes

None

Example

Like other conditional keywords, the body of arc:equals can also contain an arc:else keyword, which is 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.