split ';' REGEX (';' STRING )*

Summary

The split macro splits one or more strings into a list using a regular expression as the delimiter. Empty segments are filtered out.

Syntax

${split;<regex>[;<string>...]}

Parameters

• regex - Regular expression pattern to split on
• string - One or more strings to split

Behavior

• Splits each string using the regex pattern
• Filters out empty segments
• Combines results from all strings
• Returns comma-separated list

Examples

Split on comma:

${split;,;red,green,blue}
# Returns: "red,green,blue"

Split on whitespace:

${split;\s+;one two  three   four}
# Returns: "one,two,three,four"

Split on pipe:

${split;\|;apple|banana|cherry}
# Returns: "apple,banana,cherry"

Split multiple strings:

${split;:;path1:path2;path3:path4}
# Returns: "path1,path2,path3,path4"

Split path on separator:

${split;${pathseparator};${some.path}}

Use Cases

• Parsing delimited strings
• Breaking paths into components
• Processing formatted data
• Converting between delimiter formats
• Extracting list elements from strings

Notes

• Uses Java regex syntax
• Empty segments are automatically filtered
• Multiple input strings are processed
• See also: ${join} and ${sjoin} for combining
• See also: ${filter} for pattern-based filtering

See test cases in MacroTestsForDocsExamples.java