toclassname ';' FILES

Summary

The toclassname macro converts a list of file paths (.class or .java files) to fully qualified class names by removing the extension and converting path separators to dots.

Syntax

${toclassname;<file-paths>}

Parameters

• file-paths - Comma-separated list of file paths ending in .class or .java

Behavior

• Removes .class or .java extension
• Converts path separators (/) to dots (.)
• Generates warning for files without proper extension
• Filters out invalid paths
• Returns comma-separated list of class names

Examples

Convert class file paths:

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

Convert Java source paths:

${toclassname;org/test/TestCase.java}
# Returns: "org.test.TestCase"

Use with file lists:

classes=${toclassname;${lsr;bin;*.class}}

Mixed extensions:

${toclassname;com/Foo.java,com/Bar.class}
# Returns: "com.Foo,com.Bar"

Use Cases

• Converting build output paths to class names
• Generating class lists for manifests
• Processing compilation results
• Creating package lists from files
• Build automation and scripting
• Class path analysis

Notes

• Only processes .class and .java files
• Invalid paths generate warnings but don’t fail
• Path separator is always / (converted to .)
• Returns FQN (Fully Qualified Names)
• See also: ${toclasspath} for inverse operation

See test cases in MacroTestsForDocsExamples.java