Documentation for declarator my

Documentation for declarator my, assembled from the following types:

language documentation Variables

From Variables

(Variables) declarator my

Declaring a variable with my gives it lexical scope. This means it only exists within the current block. For example:

    my $foo = "bar";
    say $foo# OUTPUT: «"bar"␤» 
say $foo# Exception! "Variable '$foo' is not declared" 

This dies because $foo is only defined as long as we are in the same scope.

Additionally, lexical scoping means that variables can be temporarily redefined in a new scope:

my $location = "outside";
sub outer-location {
    # Not redefined: 
    say $location;
outer-location# OUTPUT: «outside␤» 
sub in-building {
    my $location = "inside";
    say $location;
in-building;    # OUTPUT: «inside␤» 
outer-location# OUTPUT: «outside␤» 

If a variable has been redefined, any code that referenced the outer variable will continue to reference the outer variable. So here, &outer-location still prints the outer $location:

sub new-location {
    my $location = "nowhere";
new-location# OUTPUT: «outside␤» 

To make new-location() print nowhere, make $location a dynamic variable using the * twigil.

my is the default scope for subroutines, so my sub x() {} and sub x() {} do exactly the same thing.