findname ';' REGEX ( ';' REPLACEMENT )?

Summary

The findname macro finds resources in the current bundle by matching filenames (not full paths) against a regular expression, with optional replacement to transform the results.

Syntax

${findname[;<regex>[;<replacement>]]}

Parameters

• regex (optional) - Regular expression to match filenames (default: “.*” matches all)
• replacement (optional) - Replacement pattern using regex groups (e.g., “$1”)

Behavior

• Searches bundle resources by filename only (not full path)
• Matches filename against regex pattern
• Optionally applies replacement to matched names
• Returns comma-separated list of results

Examples

Find all resources:

${findname}

Find by pattern:

${findname;.*\.properties}
# Returns filenames ending in .properties

Find and transform:

${findname;(.*)\.class;$1}
# Returns class names without .class extension

Extract parts of filenames:

${findname;config-(.*)\.xml;$1}
# Returns: "dev,prod,test" from "config-dev.xml", "config-prod.xml", etc.

Use Cases

• Resource discovery by name
• Filename pattern matching
• Name transformation
• Bundle content analysis
• Dynamic resource lists

Notes

• Matches filename only, not directory path
• Uses Java regex syntax
• See also: ${findpath} for full path matching
• See also: ${lsr} for file system searches

See test cases in MacroTestsForDocsExamples.java