toclasspath ';' LIST ( ';' BOOLEAN )?

Summary

The toclasspath macro converts fully qualified class names to file paths by replacing dots with path separators and optionally adding .class extension.

Syntax

${toclasspath;<class-names>[;<add-extension>]}

Parameters

• class-names - Comma-separated list of fully qualified class names
• add-extension (optional) - Boolean to add .class extension (default: true)

Behavior

• Replaces dots (.) with path separators (/)
• Optionally adds .class extension (default: yes)
• Returns comma-separated list of paths

Examples

Convert class names with extension:

${toclasspath;com.example.Main,com.example.Util}
# Returns: "com/example/Main.class,com/example/Util.class"

Convert without extension:

${toclasspath;org.test.TestCase;false}
# Returns: "org/test/TestCase"

Create paths for lookup:

paths=${toclasspath;${classes};true}

Package paths without extension:

${toclasspath;com.example.api;false}
# Returns: "com/example/api"

Use Cases

• Converting class names to resource paths
• Building file paths from class names
• Creating include/exclude patterns
• Resource lookup paths
• Build script generation
• File system operations on classes

Notes

• Always uses forward slash / as separator
• Extension parameter defaults to true
• Inverse operation of ${toclassname}
• Useful for locating class files
• See also: ${toclassname} for reverse operation

See test cases in MacroTestsForDocsExamples.java