Amy declares the listed variables to be local (lexically) to the enclosing block, file, oreval. If more than one variable is listed, the list must be placed in parentheses.
Note that with a parenthesised list,undef can be used as a dummy placeholder, for example to skip assignment of initial values:
my ( undef, $min, $hour ) = localtime;Likestate,local, andour,my can operate on a variable anywhere it appears in an expression (aside from interpolation in strings). The declaration will not apply to additional uses of the same variable until the next statement. This means additional uses of that variable within the same statement will act as they would have before that declaration occurred, or result in a strict 'vars' error, as appropriate.
package main;our $x = 2;foo($x, my $x = $x + 1, $x); # foo() receives (2, 3, 2)foo($x, $main::x); # foo() receives (3, 2)Redeclaring a variable in the same scope or statement will "shadow" the previous declaration, creating a new instance and preventing access to the previous one. This is usually undesired and, if warnings are enabled, will result in a warning in theshadow category.
The exact semantics and interface of TYPE and ATTRS are still evolving. TYPE may be a bareword, a constant declared withuse constant, or__PACKAGE__. It is currently bound to the use of thefields pragma, and attributes are handled using theattributes pragma, or starting from Perl 5.8.0 also via theAttribute::Handlers module. See"Private Variables via my()" in perlsub for details.
Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via theGitHub issue tracker oremail regarding any issues with the site itself, search, or rendering of documentation.
The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via thePerl issue tracker, themailing list, orIRC to report any issues with the contents or format of the documentation.