| Devel-Caller documentation | Contained in the Devel-Caller distribution. |
Devel::Caller - meatier versions of caller
use Devel::Caller qw(caller_cv);
$foo = sub { print "huzzah\n" if $foo == caller_cv(0) };
$foo->(); # prints huzzah
use Devel::Caller qw(called_with);
sub foo { print called_with(0,1); }
foo( my @foo ); # should print '@foo'
caller_cv gives you the coderef of the subroutine being invoked at
the call frame indicated by the value of $level
Returns the arguments passed into the caller at level $level
called_with returns a list of references to the original arguments
to the subroutine at $level. if $names is true, the names of the
variables will be returned instead
constants are returned as undef in both cases
called_as_method returns true if the subroutine at $level was
called as a method.
All of these routines are susceptible to the same limitations as
caller as described in caller in perlfunc
The deparsing of the optree perfomed by called_with is fairly simple-minded and so a bit flaky.
As a version 2.0 of Devel::Caller we no longer maintain compatibility with versions of perl earlier than 5.8.2. Older versions continue to be available from CPAN and backpan.
caller in perlfunc, PadWalker, Devel::Peek
Richard Clamp <richardc@unixbeard.net> with close reference to PadWalker by Robin Houston
Copyright (c) 2002, 2003, 2006, 2007, 2008, 2010 Richard Clamp. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.
| Devel-Caller documentation | Contained in the Devel-Caller distribution. |
use strict; package Devel::Caller; use warnings; use B; use PadWalker (); use XSLoader; use base qw( Exporter ); use 5.008; our $VERSION = '2.05'; XSLoader::load __PACKAGE__, $VERSION; our @EXPORT_OK = qw( caller_cv caller_args caller_vars called_with called_as_method ); sub caller_cv { my $level = shift; my $cx = PadWalker::_upcontext($level + 1); return unless $cx; return _context_cv($cx); } our $DEBUG = 0; sub scan_forward { my $op = shift; die "was expecting a pushmark, not a " . $op->name if ($op->name ne "pushmark"); my @stack; for (; $op && $op->name ne 'entersub'; $op = $op->next) { print "SCAN op $op ", $op->name, "\n" if $DEBUG; if ($op->name eq "pushmark") { print "push $op\n" if $DEBUG; push @stack, $op; } elsif (0) { # op consumes a mark print "pop\n" if $DEBUG; pop @stack; } } return pop @stack; } *caller_vars = \&called_with; sub called_with { my $level = shift; my $want_names = shift; my $op = _context_op( PadWalker::_upcontext( $level + 1 )); my $cv = caller_cv( $level + 2 ); my $pad = $cv ? B::svref_2object( $cv )->PADLIST : B::comppadlist; my $padn = $pad->ARRAYelt( 0 ); my $padv = $pad->ARRAYelt( 1 ); print $op->name, "\n" if $DEBUG; $op = scan_forward( $op ); print $op->name, "\n" if $DEBUG; my @return; my ($prev, $skip); $skip = 0; while (($prev = $op) && ($op = $op->next) && ($op->name ne "entersub")) { print "op $op ", $op->name, "\n" if $DEBUG; if ($op->name eq "pushmark") { $skip = !$skip; } elsif ($op->name =~ "pad(sv|av|hv)") { next if $skip; print "PAD skip:$skip\n" if $DEBUG; if ($op->next->next->name eq "sassign") { $skip = 0; next; } print "targ: ", $op->targ, "\n" if $DEBUG; my $name = $padn->ARRAYelt( $op->targ )->PVX; my $value = $padv->ARRAYelt( $op->targ )->object_2svref; push @return, $want_names ? $name : $value; next; } elsif ($op->name eq "gv") { next; } elsif ($op->name =~ /gvsv|rv2(av|hv|gv)/) { print "GV skip:$skip\n" if $DEBUG; if ($op->next->next->name eq "sassign") { $skip = 0; print "skipped\n" if $DEBUG; next; } my $consider = ($op->name eq "gvsv") ? $op : $prev; my $gv; if (ref $consider eq 'B::PADOP') { print "GV is really a padgv\n" if $DEBUG; $gv = $padv->ARRAYelt( $consider->padix ); print "NEW GV $gv\n" if $DEBUG; } else { $gv = $consider->gv; } print "consider: $consider ", $consider->name, " gv $gv\n" if $DEBUG; if ($want_names) { my %sigils = ( "gvsv" => '$', "rv2av" => '@', "rv2hv" => '%', "rv2gv" => '*', ); push @return, $sigils{ $op->name } . $gv->STASH->NAME . "::" . $gv->SAFENAME; } else { my %slots = ( "gvsv" => 'SCALAR', "rv2av" => 'ARRAY', "rv2hv" => 'HASH', "rv2gv" => 'GLOB', ); push @return, *{ $gv->object_2svref }{ $slots{ $op->name} }; } next; } elsif ($op->name eq "const") { print "const $op skip:$skip\n" if $DEBUG; if ($op->next->next->name eq "sassign") { $skip = 0; next; } push @return, $want_names ? undef : $op->sv; next; } } return @return; } sub called_as_method { my $level = shift || 0; my $op = _context_op( PadWalker::_upcontext( $level + 1 )); print "called_as_method: $op\n" if $DEBUG; die "was expecting a pushmark, not a ". $op->name unless $op->name eq "pushmark"; while (($op = $op->next) && ($op->name ne "entersub")) { print "method: ", $op->name, "\n" if $DEBUG; return 1 if $op->name =~ /^method(?:_named)?$/; } return; } sub caller_args { my $level = shift; package DB; () = caller( $level + 1 ); return @DB::args } 1; __END__