Luke Palmer > Perl6-Attributes-0.04 > Perl6::Attributes

Download:
Perl6-Attributes-0.04.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  1
View/Report Bugs
Module Version: 0.04   Source  

NAME ^

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

SYNOPSIS ^

    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 ^

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 ^

Perl6::Variables, Lexical::Attributes

AUTHOR ^

Luke Palmer <luke@luqui.org>

COPYRIGHT ^

    Copyright (C) 2005 by Luke Palmer

    This library is free software; you can redistribute it and/or modify
    it under the same terms as Perl itself, either Perl version 5.8.3 or,
    at your option, any later version of Perl 5 you may have available.
syntax highlighting: