new([$start])point($i)points()skipme([$package])to_string()to_long_string()
Devel::Backtrace - Object-oriented backtrace
This is version 0.05.
my $backtrace = Devel::Backtrace->new;
print $backtrace; # use automatic stringification
# See EXAMPLES to see what the output might look like
print $backtrace->point(0)->line;
new([$start])Constructs a new Devel::Backtrace which is filled with all the information
caller($i) provides, where $i starts from $start. If no argument is
given, $start defaults to 0.
If $start is 1 (or higher), the backtrace won't contain the information that
(and where) Devel::Backtrace::new() was called.
point($i)Returns the i'th tracepoint as a the Devel::Backtrace::Point manpage object (see its documentation for how to access every bit of information).
Note that the following code snippet will print the information of
caller($start+$i):
print Devel::Backtrace->new($start)->point($i)
points()Returns a list of all tracepoints. In scalar context, the number of tracepoints is returned.
skipme([$package])This method deletes all leading tracepoints that contain information about calls
within $package. Afterwards the $backtrace will look as though it had
been created with a higher value of $start.
If the optional parameter $package is not given, it defaults to the calling
package.
The effect is similar to what the the Carp manpage module does.
This module ships with an example "skipme.pl" that demonstrates how to use this method.
to_string()Returns a string that contains one line for each tracepoint. It will contain
the information from Devel::Backtrace::Point's to_string() method. To get
more information, use the to_long_string() method.
Note that you don't have to call to_string() if you print a Devel::Backtrace
object or otherwise treat it as a string, as the stringification operator is
overloaded.
See EXAMPLES.
to_long_string()Returns a very long string that contains several lines for each trace point. The result will contain every available bit of information. See to_long_string in the Devel::Backtrace::Point manpage for an example of what the result looks like.
A sample stringification might look like this:
Devel::Backtrace::new called from main (foo.pl:10)
main::bar called from main (foo.pl:6)
main::foo called from main (foo.pl:13)
the Devel::StackTrace manpage does mostly the same as this module. I'm afraid I haven't noticed it until I uploaded this module.
the Carp::Trace manpage is a simpler module which gives you a backtrace in string form.
Christoph Bussenius <pepe@cpan.org>
Copyright (C) 2007 Christoph Bussenius.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.