returns a symbol table object for all subtrees below @packages.
Nested Modules are analyzed recursively. If no package is given as
argument, it defaults to main. That means to get the whole symbol
table, just do a rnew without arguments.
The global variable $Devel::Symdump::MAX_RECURSION limits the recursion to prevent contention. The default value is set to 97, just low enough to survive the test suite without a warning about deep recursion.
|Devel::Symdump->new(@packages)||does not go into recursion and only analyzes the packages that are given as arguments.|
|packages, scalars, arrays, hashes, functions, ios||
The methods packages(), scalars(), arrays(), hashes(), functions(),
ios(), and (for older perls) unknowns() each return an array of fully
qualified symbols of the specified type in all packages that are held
within a Devel::Symdump object, but without the leading $, @ or
%. In a scalar context, they will return the number of such
symbols. Unknown symbols are usually either formats or variables that
havent yet got a defined value.
Note that scalar symbol table entries are a special case. If a symbol table entry exists at all, presence of a scalar is currently unknowable, due to a feature of Perl described in perlref Making References point 7. For example, this package will mark a scalar value $foo as present if any of @foo, %foo, &foo etc. have been declared or used.
|as_HTML||As_string() and as_HTML() return a simple string/HTML representations of the object.|
|diff||Diff() prints the difference between two Devel::Symdump objects in human readable form. The format is similar to the one used by the as_string method.|
|inh_tree||Isa_tree() and inh_tree() both return a simple string representation of the current inheritance tree. The difference between the two methods is the direction from which the tree is viewed: top-down or bottom-up. As Im sure, many users will have different expectation about what is top and what is bottom, Ill provide an example what happens when the Socket module is loaded:|
|% print Devel::Symdump->inh_tree||
The inh_tree method shows on the left hand side a package name and indented to the right the packages that use the former.
|% print Devel::Symdump->isa_tree|
The design of this package is intentionally primitive and allows it to be subclassed easily. An example of a (maybe) useful subclass is Devel::Symdump::Export, a package which exports all methods of the Devel::Symdump package and turns them into functions.
Andreas Koenig <firstname.lastname@example.org> and Tom Christiansen <email@example.com>. Based on the old dumpvar.pl by Larry Wall.
This module is
Copyright (c) 1995, 1997, 2000, 2002, 2005, 2006 Andreas Koenig <firstname.lastname@example.org>.
All rights reserved.
This library is free software; you may use, redistribute and/or modify it under the same terms as Perl itself.
|perl v5.20.3||DEVEL::SYMDUMP (3)||2013-03-24|