indexof ';' STRING (';' LIST )*

Summary

The indexof macro searches for a value in combined lists and returns its 0-based index position, or -1 if not found.

Syntax

${indexof;<value>;<list>[;<list>...]}

Parameters

• value - The value to search for
• list - One or more comma-separated lists to search in

Behavior

• Combines all lists into one
• Searches for exact match of value
• Returns 0-based index of first occurrence
• Returns -1 if value not found
• Case-sensitive search

Examples

Find value in list:

${indexof;green;red,green,blue}
# Returns: 1

Not found:

${indexof;yellow;red,green,blue}
# Returns: -1

Search multiple lists:

${indexof;target;${list1};${list2}}

Check if value exists:

${if;${matches;${indexof;test;${list}};-?[0-9]+};found;not-found}

Use Cases

• Finding element positions
• Checking list membership
• List searching operations
• Conditional logic based on presence
• Array indexing

Notes

• Returns integer index (0-based)
• First occurrence only
• Case-sensitive
• Combines multiple lists before searching
• See also: ${lastindexof} for last occurrence
• See also: ${find} for substring search in strings

See test cases in MacroTestsForDocsExamples.java