devel::argnames(3pm) [debian man page]

Devel::ArgNames(3pm)					User Contributed Perl Documentation				      Devel::ArgNames(3pm)

NAME

       Devel::ArgNames - Figure out the names of variables passed into subroutines.

SYNOPSIS

	       use Devel::ArgNames;

	       sub foo {
		       warn "foo() called with arguments: "
			       . join(", ", map { defined() ? $_ : "<unknown>" } arg_names(@_) );
	       }

	       foo($bar, $gorch, $blah[4]);

DESCRIPTION

       When print-debugging code, you will often ind yourself going:

	       print "$foo is $foo, $bar is $bar"

       With this module, you can write a reusable subroutine easily:

	       sub my_print_vars {
		       my %vars;

		       @vars{arg_names()} = @_;

		       foreach my $var ( keys %vars ) {
			       warn "$var is $vars{$var}
";
		       }
	       }

	       my_print_vars($foo, $bar);

       This module doesn't provide dumping facilities because there are too many to choose from. This is a DIY kit ;-)

EXPORTS

       arg_names [ $level ]
	   This function will return the names associated with the variables found on @_, at the level $level. If $level is not provided
	   "arg_names"'s caller's caller will be used ("$level == 2" in that case).

VERSION CONTROL

       This module is maintained using Darcs. You can get the latest version from <http://nothingmuch.woobling.org/Devel-ArgNames/>, and use
       "darcs send" to commit changes.

SEE ALSO

       Data::Dumper::Simple, DB, Devel::Caller, Devel::Caller::Perl, PadWalker.

AUTHORS

       Ran Eilam

       Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT

	       Copyright (c) 2007 Yuval Kogman. All rights reserved
	       This program is free software; you can redistribute
	       it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2008-01-02						      Devel::ArgNames(3pm)

Devel::Caller(3)					User Contributed Perl Documentation					  Devel::Caller(3)

NAME

       Devel::Caller - meatier versions of "caller"

SYNOPSIS

	use Devel::Caller qw(caller_cv);
	$foo = sub { print "huzzah
" 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'

DESCRIPTION

       caller_cv($level)
	   "caller_cv" gives you the coderef of the subroutine being invoked at the call frame indicated by the value of $level

       caller_args($level)
	   Returns the arguments passed into the caller at level $level

       caller_vars( $level, $names ) =item called_with($level, $names)
	   "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($level)
	   "called_as_method" returns true if the subroutine at $level was called as a method.

BUGS

       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.

       o   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.

SEE ALSO

       "caller" in perlfunc, PadWalker, Devel::Peek

AUTHOR

       Richard Clamp <richardc@unixbeard.net> with close reference to PadWalker by Robin Houston

COPYRIGHT

       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.

POD ERRORS

       Hey! The above document had some coding errors, which are explained below:

       Around line 214:
	   You forgot a '=back' before '=head1'

perl v5.16.2							    2010-04-08							  Devel::Caller(3)