NAME
Symbol::Move - Move or rename symbols at compile time.
DESCRIPTION
This package allows you to make move symbols in the current package, between the current package and other packages, or between any arbitrary packages.
SYNOPSYS
use Symbol::Move(
'foo' => 'bar', # Move the sub foo in the current package to the name bar.
'%A::B::foo' => 'bar', # Move the %A::B::foo hash to the %bar symbol in the current package.
'@foo' => 'A::B::bar', # Move the @foo array in the current package to the @A::B::bar symbol.
);USAGE
use Symbol::Move $SYMBOL => $NEW_NAME, ...;$SYMBOL must be a string identifying the symbol. The symbol string must include the sigil unless it is a subroutine. You can provide a fully qualified symbol name, or it will be assumed the symbol is in $PACKAGE.
$NEW_NAME must be a string identifying the symbol. The string may include a symbol, or the sigil from the $SYMBOL string will be used. The string can be a fully qualified symbol name, or it will be assumed that the new name is in $PACKAGE.
USEFUL FOR RENAMING IMPORTS
package Foo;
{
package Foo::Scratch;
use Some::Exporter qw/xyz/;
}
use Symbol::Move '&Foo::Scratch::xyz' => 'my_xyz';
my_xyz(' => 'my_xyz';
my_xyz(...);SEE ALSO
- Symbol::Alias
-
Symbol::Alias Allows you to set up aliases within a package at compile-time.
- Symbol::Delete
-
Symbol::Delete Allows you to remove symbols from a package at compile time.
- Symbol::Extract
-
Symbol::Extract Allows you to extract symbols from packages and into variables at compile time.
- Symbol::Methods
-
Symbol::Methods introduces several package methods for managing symbols.
SOURCE
The source code repository for symbol can be found at http://github.com/exodist/Symbol-Move.
MAINTAINERS
AUTHORS
COPYRIGHT
Copyright 2015 Chad Granum <exodist7@gmail.com>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://dev.perl.org/licenses/