Perl6::Attributes - Perl 6-like member variable syntax


Perl6-Attributes documentation  | view source Contained in the Perl6-Attributes distribution.

Index


NAME

Top

Perl6::Attributes - Perl 6-like member variable syntax

SYNOPSIS

Top

    package Foo;
    use Perl6::Attributes;

    sub new {
        my ($class) = @_;
        bless { 
            a  => 1,
            b  => [ 2, 3, 4 ],
            c  => { hello => "World" },
        } => ref $class || $class;
    }

    sub example {
        my ($self) = @_;
        $.a;        # 1
        $.b[2];     # 4
        @.b;        # 2 3 4
        $#.b;       # 3
        $.c{hello}; # World
        keys %.c;   # hello
        print "I get the idea";
    }

DESCRIPTION

Top

I found myself annoyed when I wrote the following code in one of my recent projects:

    sub populate {
        my ($self, $n) = @_;
        for (1..$n) {
            push @{$self->{organisms}}, Organism->new(rand($self->{width}), rand($self->{height}));
        }
    }

Three $selfs in one line! And it's really not encoding any information, it's just clutter that results from Perl's lack of explicit object-oriented support. However, Using the magic of source filters, we can now write it:

    sub populate {
        my ($self, $n) = @_;
        for (1..$n) {
            push @.organisms, Organism->new(rand($.width), rand($.height));
        }
    }

Perl6::Attributes takes the Perl 6 secondary sigil . and translates it into a hash access on $self. No, it doesn't support other names for your invocant (but it could very easily; I'm just lazy), and no, it doesn't support objects written by crazy people based on array, scalar, or (!) glob references.

You still inflect the primary sigil, unlike in Perl 6. See Perl6::Variables for a way to use Perl 6's uninflected sigils... but don't expect it to work with this module.

There's also a nice little "feature" that you get for trading the ability to name your variables the same with different sigils (by the way, you can't do that). Say $self->{foo} is an array ref:

    @.foo;       # the array itself
    $.foo;       # the reference

Which means that even if you're using an array referentially, you can usually avoid writing those pesky @{}s everywhere.

Perl6::Attributes now also translates ./method and ./method(args) to $self-method> and $self-method(args)>.

SEE ALSO

Top

Perl6::Variables, Lexical::Attributes

AUTHOR

Top

Luke Palmer <luke@luqui.org>

COPYRIGHT

Top


Perl6-Attributes documentation  | view source Contained in the Perl6-Attributes distribution.