castxml

Generate XML from C++ header

$ castxml --castxml-output=1 [header.hpp] -o [output.xml]

$ castxml --castxml-gccxml [header.hpp] -o [output.xml]

$ castxml --castxml-cc-gnu [g++] [header.hpp] -o [output.xml]

$ castxml --castxml-start [ClassName] [header.hpp] -o [output.xml]

$ castxml -I[/include/path] -D[MACRO] [header.hpp] -o [output.xml]

castxml [options] inputfile_

castxml creates an XML representation of C and C++ declarations from source files. It uses the Clang compiler frontend to parse C-family source code and produces a structured XML output describing types, functions, classes, and other declarations.
The tool is commonly used as a foundation for generating language bindings, enabling projects like pygccxml to automatically create Python wrappers for C++ libraries. It also serves as a code analysis backend where machine-readable representations of header files are needed.
CastXML was created as a replacement for the deprecated GCC-XML tool, providing a modern Clang-based alternative with compatible output formats for backward compatibility.

--castxml-output=version

Generate castxml-format output (version must be '1')

Generate gccxml-compatible output format

Configure preprocessor/target for GNU compiler

Configure preprocessor/target for MSVC compiler

Configure for GNU C compiler

Configure for MSVC C compiler

Start AST traversal at named declaration

Output file path

Add include search path

Define preprocessor macro

C++ standard (c++11, c++14, c++17, etc.)

Language bindings

Generate bindings for Python, Rust, etc.

Parse and analyze C++ codebases

Extract API information

Output format depends on selected option. GCCXML format provided for legacy compatibility. Use with pygccxml for Python-based analysis.

clang(1), g++(1)