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}\n";
        }
}
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.