CORBA::IDLtree is a Perl module that builds abstract syntax trees from CORBA IDL.

The main export is sub Parse_File which takes an IDL input file name as the parameter, and returns a reference to an array of references to the root nodes constructed (or 0 if there were syntax errors.)

Parse_File uses two auxiliary data structures:

@include_path - Paths where to look for included IDL files
%defines - Symbol definitions for the preprocessor
(cf. the -D switch on many C compilers)
where -DSYM=VAL is represented as
$defines{SYM} = VAL. -DSYM is represented as
$defines{SYM} = 1.

A further export is the sub Dump_Symbols which takes the return value
of Parse_File as the parameter, and prints the trees constructed to
stdout in IDL syntax.