reject ‘;’ LIST ‘;’ REGEX

Rejects a list by matching it against a regular expression

Summary

Filter a list to exclude elements that match a regular expression. This macro is an alias for the filterout macro.

Syntax

${reject;<list>;<regex>}

Parameters

list: Comma-separated list of elements to filter
regex: Regular expression pattern to match against

Behavior

Returns a new list containing only the elements from the input list that do not match the specified regular expression pattern.

This macro is functionally identical to filterout.

Examples

# Reject items starting with "test"
packages = com.example.api, com.example.test, com.example.impl
${reject;${packages};.*\.test}
# Returns: com.example.api,com.example.impl

# Exclude test files
files = Main.java, Test.java, Helper.java, TestHelper.java
${reject;${files};.*Test.*}
# Returns: Main.java,Helper.java

# Exclude internal packages
all-packages = com.company.api, com.company.internal, com.company.util
-exportpackage: ${reject;${all-packages};.*\.internal.*}
# Returns: com.company.api,com.company.util

# Remove snapshot versions
versions = 1.0.0, 2.0.0-SNAPSHOT, 3.0.0
${reject;${versions};.*SNAPSHOT.*}
# Returns: 1.0.0,3.0.0

Use Cases

Package Exclusion: Exclude internal or test packages from exports
File Filtering: Remove unwanted files from a list
Dependency Filtering: Exclude specific dependencies by pattern
Clean-up: Remove items matching unwanted patterns

Notes

This is an alias for the filterout macro - they behave identically
Uses Java regular expression syntax
Elements are matched in their entirety (use .* for partial matching)
The opposite operation is provided by select or filter

filterout - Identical functionality (primary name)
select / filter - Include only elements matching regex
removeall - Remove specific elements from a list
retainall - Keep only elements present in another list

TODO Needs review - AI Generated content

See test cases in MacroTestsForDocsExamples.java

reject ';' LIST ';' REGEX