is ( ';' ANY )*

Summary

The is macro checks if all provided arguments are equal to each other. Returns true if all values match, false otherwise.

Syntax

${is;<value>;<value>[;<value>...]}

Parameters

• value - Two or more values to compare (minimum 2 required)

Behavior

• Compares all arguments using string equality
• Returns true only if all values are exactly equal
• Requires at least 2 arguments
• Case-sensitive comparison

Examples

Check equality of two values:

${if;${is;${version};1.0.0};version-match;version-mismatch}

Compare multiple values:

${is;abc;abc;abc}
# Returns: true

Check property equality:

${if;${is;${env};production};prod-config;dev-config}

Validate configuration:

${is;${driver};gradle;gradle}
# Returns: true if driver is gradle

Use Cases

• Validating that values match
• Conditional logic based on equality
• Configuration validation
• Multi-value consistency checks
• String comparison in conditionals

Notes

• All arguments must be exactly equal (string comparison)
• Case-sensitive
• Empty strings are valid values
• See also: ${equals} for two-value comparison
• Useful with ${if} for conditional logic

See test cases in MacroTestsForDocsExamples.java