PERLTOOT(1) Perl Programmers Reference Guide PERLTOOT(1)
NAME
perltoot - Toms object-oriented tutorial for perl
DESCRIPTION
Object-oriented programming is a big seller these days. Some managers
would rather have objects than sliced bread. Why is that? Whats so
special about an object? Just what is an object anyway?
An object is nothing but a way of tucking away complex behaviours into
a neat little easy-to-use bundle. (This is what professors call
abstraction.) Smart people who have nothing to do but sit around for
weeks on end figuring out really hard problems make these nifty objects
that even regular people can use. (This is what professors call soft
ware reuse.) Users (well, programmers) can play with this little bun
dle all they want, but they arent to open it up and mess with the
insides. Just like an expensive piece of hardware, the contract says
that you void the warranty if you muck with the cover. So dont do
that.
The heart of objects is the class, a protected little private namespace
full of data and functions. A class is a set of related routines that
addresses some problem area. You can think of it as a user-defined
type. The Perl package mechanism, also used for more traditional mod
ules, is used for class modules as well. Objects "live" in a class,
meaning that they belong to some package.
More often than not, the class provides the user with little bundles.
These bundles are objects. They know whose class they belong to, and
how to behave. Users ask the class to do something, like "give me an
object." Or they can ask one of these objects to do something. Asking
a class to do something for you is calling a class method. Asking an
object to do something for you is calling an object method. Asking
either a class (usually) or an object (sometimes) to give you back an
object is calling a constructor, which is just a kind of method.
Thats all well and good, but how is an object different from any other
Perl data type? Just what is an object really; that is, whats its
fundamental type? The answer to the first question is easy. An object
is different from any other data type in Perl in one and only one way:
you may dereference it using not merely string or numeric subscripts as
with simple arrays and hashes, but with named subroutine calls. In a
word, with methods.
The answer to the second question is that its a reference, and not
just any reference, mind you, but one whose referent has been bless()ed
into a particular class (read: package). What kind of reference?
Well, the answer to that one is a bit less concrete. Thats because in
Perl the designer of the class can employ any sort of reference theyd
like as the underlying intrinsic data type. It could be a scalar, an
array, or a hash reference. It could even be a code reference. But
because of its inherent flexibility, an object is usually a hash refer
ence.
Creating a Class
Before you create a class, you need to decide what to name it. Thats
because the class (package) name governs the name of the file used to
house it, just as with regular modules. Then, that class (package)
should provide one or more ways to generate objects. Finally, it
should provide mechanisms to allow users of its objects to indirectly
manipulate these objects from a distance.
For example, lets make a simple Person class module. It gets stored
in the file Person.pm. If it were called a Happy::Person class, it
would be stored in the file Happy/Person.pm, and its package would
become Happy::Person instead of just Person. (On a personal computer
not running Unix or Plan 9, but something like Mac OS or VMS, the
directory separator may be different, but the principle is the same.)
Do not assume any formal relationship between modules based on their
directory names. This is merely a grouping convenience, and has no
effect on inheritance, variable accessibility, or anything else.
For this module we arent going to use Exporter, because were a well-
behaved class module that doesnt export anything at all. In order to
manufacture objects, a class needs to have a constructor method. A
constructor gives you back not just a regular data type, but a brand-
new object in that class. This magic is taken care of by the bless()
function, whose sole purpose is to enable its referent to be used as an
object. Remember: being an object really means nothing more than that
methods may now be called against it.
While a constructor may be named anything youd like, most Perl pro
grammers seem to like to call theirs new(). However, new() is not a
reserved word, and a class is under no obligation to supply such. Some
programmers have also been known to use a function with the same name
as the class as the constructor.
Object Representation
By far the most common mechanism used in Perl to represent a Pascal
record, a C struct, or a C++ class is an anonymous hash. Thats
because a hash has an arbitrary number of data fields, each conve
niently accessed by an arbitrary name of your own devising.
If you were just doing a simple struct-like emulation, you would likely
go about it something like this:
$rec = {
name => "Jason",
age => 23,
peers => [ "Norbert", "Rhys", "Phineas"],
};
If you felt like it, you could add a bit of visual distinction by up-
casing the hash keys:
$rec = {
NAME => "Jason",
AGE => 23,
PEERS => [ "Norbert", "Rhys", "Phineas"],
};
And so you could get at "$rec->{NAME}" to find "Jason", or "@{
$rec->{PEERS} }" to get at "Norbert", "Rhys", and "Phineas". (Have you
ever noticed how many 23-year-old programmers seem to be named "Jason"
these days? :-)
This same model is often used for classes, although it is not consid
ered the pinnacle of programming propriety for folks from outside the
class to come waltzing into an object, brazenly accessing its data mem
bers directly. Generally speaking, an object should be considered an
opaque cookie that you use object methods to access. Visually, methods
look like youre dereffing a reference using a function name instead of
brackets or braces.
Class Interface
Some languages provide a formal syntactic interface to a classs meth
ods, but Perl does not. It relies on you to read the documentation of
each class. If you try to call an undefined method on an object, Perl
wont complain, but the program will trigger an exception while its
running. Likewise, if you call a method expecting a prime number as
its argument with a non-prime one instead, you cant expect the com
piler to catch this. (Well, you can expect it all you like, but its
not going to happen.)
Lets suppose you have a well-educated user of your Person class, some
one who has read the docs that explain the prescribed interface.
Heres how they might use the Person class:
use Person;
$him = Person->new();
$him->name("Jason");
$him->age(23);
$him->peers( "Norbert", "Rhys", "Phineas" );
push @All_Recs, $him; # save object in array for later
printf "%s is %d years old.\n", $him->name, $him->age;
print "His peers are: ", join(", ", $him->peers), "\n";
printf "Last recs name is %s\n", $All_Recs[-1]->name;
As you can see, the user of the class doesnt know (or at least, has no
business paying attention to the fact) that the object has one particu
lar implementation or another. The interface to the class and its
objects is exclusively via methods, and thats all the user of the
class should ever play with.
Constructors and Instance Methods
Still, someone has to know whats in the object. And that someone is
the class. It implements methods that the programmer uses to access
the object. Heres how to implement the Person class using the stan
dard hash-ref-as-an-object idiom. Well make a class method called
new() to act as the constructor, and three object methods called
name(), age(), and peers() to get at per-object data hidden away in our
anonymous hash.
package Person;
use strict;
##################################################
## the object constructor (simplistic version) ##
##################################################
sub new {
my $self = {};
$self->{NAME} = undef;
$self->{AGE} = undef;
$self->{PEERS} = [];
bless($self); # but see below
return $self;
}
##############################################
## methods to access per-object data ##
## ##
## With args, they set the value. Without ##
## any, they only retrieve it/them. ##
##############################################
sub name {
my $self = shift;
if (@_) { $self->{NAME} = shift }
return $self->{NAME};
}
sub age {
my $self = shift;
if (@_) { $self->{AGE} = shift }
return $self->{AGE};
}
sub peers {
my $self = shift;
if (@_) { @{ $self->{PEERS} } = @_ }
return @{ $self->{PEERS} };
}
1; # so the require or use succeeds
Weve created three methods to access an objects data, name(), age(),
and peers(). These are all substantially similar. If called with an
argument, they set the appropriate field; otherwise they return the
value held by that field, meaning the value of that hash key.
Planning for the Future: Better Constructors
Even though at this point you may not even know what it means, someday
youre going to worry about inheritance. (You can safely ignore this
for now and worry about it later if youd like.) To ensure that this
all works out smoothly, you must use the double-argument form of
bless(). The second argument is the class into which the referent will
be blessed. By not assuming our own class as the default second argu
ment and instead using the class passed into us, we make our construc
tor inheritable.
sub new {
my $class = shift;
my $self = {};
$self->{NAME} = undef;
$self->{AGE} = undef;
$self->{PEERS} = [];
bless ($self, $class);
return $self;
}
Thats about all there is for constructors. These methods bring
objects to life, returning neat little opaque bundles to the user to be
used in subsequent method calls.
Destructors
Every story has a beginning and an end. The beginning of the objects
story is its constructor, explicitly called when the object comes into
existence. But the ending of its story is the destructor, a method
implicitly called when an object leaves this life. Any per-object
clean-up code is placed in the destructor, which must (in Perl) be
called DESTROY.
If constructors can have arbitrary names, then why not destructors?
Because while a constructor is explicitly called, a destructor is not.
Destruction happens automatically via Perls garbage collection (GC)
system, which is a quick but somewhat lazy reference-based GC system.
To know what to call, Perl insists that the destructor be named
DESTROY. Perls notion of the right time to call a destructor is not
well-defined currently, which is why your destructors should not rely
on when they are called.
Why is DESTROY in all caps? Perl on occasion uses purely uppercase
function names as a convention to indicate that the function will be
automatically called by Perl in some way. Others that are called
implicitly include BEGIN, END, AUTOLOAD, plus all methods used by tied
objects, described in perltie.
In really good object-oriented programming languages, the user doesnt
care when the destructor is called. It just happens when its supposed
to. In low-level languages without any GC at all, theres no way to
depend on this happening at the right time, so the programmer must
explicitly call the destructor to clean up memory and state, crossing
their fingers that its the right time to do so. Unlike C++, an
object destructor is nearly never needed in Perl, and even when it is,
explicit invocation is uncalled for. In the case of our Person class,
we dont need a destructor because Perl takes care of simple matters
like memory deallocation.
The only situation where Perls reference-based GC wont work is when
theres a circularity in the data structure, such as:
$this->{WHATEVER} = $this;
In that case, you must delete the self-reference manually if you expect
your program not to leak memory. While admittedly error-prone, this is
the best we can do right now. Nonetheless, rest assured that when your
program is finished, its objects destructors are all duly called. So
you are guaranteed that an object eventually gets properly destroyed,
except in the unique case of a program that never exits. (If youre
running Perl embedded in another application, this full GC pass happens
a bit more frequently--whenever a thread shuts down.)
Other Object Methods
The methods weve talked about so far have either been constructors or
else simple "data methods", interfaces to data stored in the object.
These are a bit like an objects data members in the C++ world, except
that strangers dont access them as data. Instead, they should only
access the objects data indirectly via its methods. This is an impor
tant rule: in Perl, access to an objects data should only be made
through methods.
Perl doesnt impose restrictions on who gets to use which methods. The
public-versus-private distinction is by convention, not syntax. (Well,
unless you use the Alias module described below in "Data Members as
Variables".) Occasionally youll see method names beginning or ending
with an underscore or two. This marking is a convention indicating
that the methods are private to that class alone and sometimes to its
closest acquaintances, its immediate subclasses. But this distinction
is not enforced by Perl itself. Its up to the programmer to behave.
Theres no reason to limit methods to those that simply access data.
Methods can do anything at all. The key point is that theyre invoked
against an object or a class. Lets say wed like object methods that
do more than fetch or set one particular field.
sub exclaim {
my $self = shift;
return sprintf "Hi, Im %s, age %d, working with %s",
$self->{NAME}, $self->{AGE}, join(", ", @{$self->{PEERS}});
}
Or maybe even one like this:
sub happy_birthday {
my $self = shift;
return ++$self->{AGE};
}
Some might argue that one should go at these this way:
sub exclaim {
my $self = shift;
return sprintf "Hi, Im %s, age %d, working with %s",
$self->name, $self->age, join(", ", $self->peers);
}
sub happy_birthday {
my $self = shift;
return $self->age( $self->age() + 1 );
}
But since these methods are all executing in the class itself, this may
not be critical. There are tradeoffs to be made. Using direct hash
access is faster (about an order of magnitude faster, in fact), and
its more convenient when you want to interpolate in strings. But
using methods (the external interface) internally shields not just the
users of your class but even you yourself from changes in your data
representation.
Class Data
What about "class data", data items common to each object in a class?
What would you want that for? Well, in your Person class, you might
like to keep track of the total people alive. How do you implement
that?
You could make it a global variable called $Person::Census. But about
only reason youd do that would be if you wanted people to be able to
get at your class data directly. They could just say $Person::Census
and play around with it. Maybe this is ok in your design scheme. You
might even conceivably want to make it an exported variable. To be
exportable, a variable must be a (package) global. If this were a tra
ditional module rather than an object-oriented one, you might do that.
While this approach is expected in most traditional modules, its gen
erally considered rather poor form in most object modules. In an
object module, you should set up a protective veil to separate inter
face from implementation. So provide a class method to access class
data just as you provide object methods to access object data.
So, you could still keep $Census as a package global and rely upon oth
ers to honor the contract of the module and therefore not play around
with its implementation. You could even be supertricky and make $Cen
sus a tied object as described in perltie, thereby intercepting all
accesses.
But more often than not, you just want to make your class data a file-
scoped lexical. To do so, simply put this at the top of the file:
my $Census = 0;
Even though the scope of a my() normally expires when the block in
which it was declared is done (in this case the whole file being
required or used), Perls deep binding of lexical variables guarantees
that the variable will not be deallocated, remaining accessible to
functions declared within that scope. This doesnt work with global
variables given temporary values via local(), though.
Irrespective of whether you leave $Census a package global or make it
instead a file-scoped lexical, you should make these changes to your
Person::new() constructor:
sub new {
my $class = shift;
my $self = {};
$Census++;
$self->{NAME} = undef;
$self->{AGE} = undef;
$self->{PEERS} = [];
bless ($self, $class);
return $self;
}
sub population {
return $Census;
}
Now that weve done this, we certainly do need a destructor so that
when Person is destroyed, the $Census goes down. Heres how this could
be done:
sub DESTROY { --$Census }
Notice how theres no memory to deallocate in the destructor? Thats
something that Perl takes care of for you all by itself.
Alternatively, you could use the Class::Data::Inheritable module from
CPAN.
Accessing Class Data
It turns out that this is not really a good way to go about handling
class data. A good scalable rule is that you must never reference
class data directly from an object method. Otherwise you arent build
ing a scalable, inheritable class. The object must be the rendezvous
point for all operations, especially from an object method. The glob
als (class data) would in some sense be in the "wrong" package in your
derived classes. In Perl, methods execute in the context of the class
they were defined in, not that of the object that triggered them.
Therefore, namespace visibility of package globals in methods is unre
lated to inheritance.
Got that? Maybe not. Ok, lets say that some other class "borrowed"
(well, inherited) the DESTROY method as it was defined above. When
those objects are destroyed, the original $Census variable will be
altered, not the one in the new classs package namespace. Perhaps
this is what you want, but probably it isnt.
Heres how to fix this. Well store a reference to the data in the
value accessed by the hash key "_CENSUS". Why the underscore? Well,
mostly because an initial underscore already conveys strong feelings of
magicalness to a C programmer. Its really just a mnemonic device to
remind ourselves that this field is special and not to be used as a
public data member in the same way that NAME, AGE, and PEERS are.
(Because weve been developing this code under the strict pragma, prior
to perl version 5.004 well have to quote the field name.)
sub new {
my $class = shift;
my $self = {};
$self->{NAME} = undef;
$self->{AGE} = undef;
$self->{PEERS} = [];
# "private" data
$self->{"_CENSUS"} = \$Census;
bless ($self, $class);
++ ${ $self->{"_CENSUS"} };
return $self;
}
sub population {
my $self = shift;
if (ref $self) {
return ${ $self->{"_CENSUS"} };
} else {
return $Census;
}
}
sub DESTROY {
my $self = shift;
-- ${ $self->{"_CENSUS"} };
}
Debugging Methods
Its common for a class to have a debugging mechanism. For example,
you might want to see when objects are created or destroyed. To do
that, add a debugging variable as a file-scoped lexical. For this,
well pull in the standard Carp module to emit our warnings and fatal
messages. That way messages will come out with the callers filename
and line number instead of our own; if we wanted them to be from our
own perspective, wed just use die() and warn() directly instead of
croak() and carp() respectively.
use Carp;
my $Debugging = 0;
Now add a new class method to access the variable.
sub debug {
my $class = shift;
if (ref $class) { confess "Class method called as object method" }
unless (@_ == 1) { confess "usage: CLASSNAME->debug(level)" }
$Debugging = shift;
}
Now fix up DESTROY to murmur a bit as the moribund object expires:
sub DESTROY {
my $self = shift;
if ($Debugging) { carp "Destroying $self " . $self->name }
-- ${ $self->{"_CENSUS"} };
}
One could conceivably make a per-object debug state. That way you
could call both of these:
Person->debug(1); # entire class
$him->debug(1); # just this object
To do so, we need our debugging method to be a "bimodal" one, one that
works on both classes and objects. Therefore, adjust the debug() and
DESTROY methods as follows:
sub debug {
my $self = shift;
confess "usage: thing->debug(level)" unless @_ == 1;
my $level = shift;
if (ref($self)) {
$self->{"_DEBUG"} = $level; # just myself
} else {
$Debugging = $level; # whole class
}
}
sub DESTROY {
my $self = shift;
if ($Debugging || $self->{"_DEBUG"}) {
carp "Destroying $self " . $self->name;
}
-- ${ $self->{"_CENSUS"} };
}
What happens if a derived class (which well call Employee) inherits
methods from this Person base class? Then "Employee->debug()", when
called as a class method, manipulates $Person::Debugging not
$Employee::Debugging.
Class Destructors
The object destructor handles the death of each distinct object. But
sometimes you want a bit of cleanup when the entire class is shut down,
which currently only happens when the program exits. To make such a
class destructor, create a function in that classs package named END.
This works just like the END function in traditional modules, meaning
that it gets called whenever your program exits unless it execs or dies
of an uncaught signal. For example,
sub END {
if ($Debugging) {
print "All persons are going away now.\n";
}
}
When the program exits, all the class destructors (END functions) are
be called in the opposite order that they were loaded in (LIFO order).
Documenting the Interface
And there you have it: weve just shown you the implementation of this
Person class. Its interface would be its documentation. Usually this
means putting it in pod ("plain old documentation") format right there
in the same file. In our Person example, we would place the following
docs anywhere in the Person.pm file. Even though it looks mostly like
code, its not. Its embedded documentation such as would be used by
the pod2man, pod2html, or pod2text programs. The Perl compiler ignores
pods entirely, just as the translators ignore code. Heres an example
of some pods describing the informal interface:
=head1 NAME
Person - class to implement people
=head1 SYNOPSIS
use Person;
#################
# class methods #
#################
$ob = Person->new;
$count = Person->population;
#######################
# object data methods #
#######################
### get versions ###
$who = $ob->name;
$years = $ob->age;
@pals = $ob->peers;
### set versions ###
$ob->name("Jason");
$ob->age(23);
$ob->peers( "Norbert", "Rhys", "Phineas" );
########################
# other object methods #
########################
$phrase = $ob->exclaim;
$ob->happy_birthday;
=head1 DESCRIPTION
The Person class implements dah dee dah dee dah....
Thats all there is to the matter of interface versus implementation.
A programmer who opens up the module and plays around with all the pri
vate little shiny bits that were safely locked up behind the interface
contract has voided the warranty, and you shouldnt worry about their
fate.
Aggregation
Suppose you later want to change the class to implement better names.
Perhaps youd like to support both given names (called Christian names,
irrespective of ones religion) and family names (called surnames),
plus nicknames and titles. If users of your Person class have been
properly accessing it through its documented interface, then you can
easily change the underlying implementation. If they havent, then
they lose and its their fault for breaking the contract and voiding
their warranty.
To do this, well make another class, this one called Fullname. Whats
the Fullname class look like? To answer that question, you have to
first figure out how you want to use it. How about we use it this way:
$him = Person->new();
$him->fullname->title("St");
$him->fullname->christian("Thomas");
$him->fullname->surname("Aquinas");
$him->fullname->nickname("Tommy");
printf "His normal name is %s\n", $him->name;
printf "But his real name is %s\n", $him->fullname->as_string;
Ok. To do this, well change Person::new() so that it supports a full
name field this way:
sub new {
my $class = shift;
my $self = {};
$self->{FULLNAME} = Fullname->new();
$self->{AGE} = undef;
$self->{PEERS} = [];
$self->{"_CENSUS"} = \$Census;
bless ($self, $class);
++ ${ $self->{"_CENSUS"} };
return $self;
}
sub fullname {
my $self = shift;
return $self->{FULLNAME};
}
Then to support old code, define Person::name() this way:
sub name {
my $self = shift;
return $self->{FULLNAME}->nickname(@_)
|| $self->{FULLNAME}->christian(@_);
}
Heres the Fullname class. Well use the same technique of using a
hash reference to hold data fields, and methods by the appropriate name
to access them:
package Fullname;
use strict;
sub new {
my $class = shift;
my $self = {
TITLE => undef,
CHRISTIAN => undef,
SURNAME => undef,
NICK => undef,
};
bless ($self, $class);
return $self;
}
sub christian {
my $self = shift;
if (@_) { $self->{CHRISTIAN} = shift }
return $self->{CHRISTIAN};
}
sub surname {
my $self = shift;
if (@_) { $self->{SURNAME} = shift }
return $self->{SURNAME};
}
sub nickname {
my $self = shift;
if (@_) { $self->{NICK} = shift }
return $self->{NICK};
}
sub title {
my $self = shift;
if (@_) { $self->{TITLE} = shift }
return $self->{TITLE};
}
sub as_string {
my $self = shift;
my $name = join(" ", @$self{CHRISTIAN, SURNAME});
if ($self->{TITLE}) {
$name = $self->{TITLE} . " " . $name;
}
return $name;
}
1;
Finally, heres the test program:
#!/usr/bin/perl -w
use strict;
use Person;
sub END { show_census() }
sub show_census () {
printf "Current population: %d\n", Person->population;
}
Person->debug(1);
show_census();
my $him = Person->new();
$him->fullname->christian("Thomas");
$him->fullname->surname("Aquinas");
$him->fullname->nickname("Tommy");
$him->fullname->title("St");
$him->age(1);
printf "%s is really %s.\n", $him->name, $him->fullname->as_string;
printf "%ss age: %d.\n", $him->name, $him->age;
$him->happy_birthday;
printf "%ss age: %d.\n", $him->name, $him->age;
show_census();
Inheritance
Object-oriented programming systems all support some notion of inheri
tance. Inheritance means allowing one class to piggy-back on top of
another one so you dont have to write the same code again and again.
Its about software reuse, and therefore related to Laziness, the prin
cipal virtue of a programmer. (The import/export mechanisms in tradi
tional modules are also a form of code reuse, but a simpler one than
the true inheritance that you find in object modules.)
Sometimes the syntax of inheritance is built into the core of the lan
guage, and sometimes its not. Perl has no special syntax for specify
ing the class (or classes) to inherit from. Instead, its all strictly
in the semantics. Each package can have a variable called @ISA, which
governs (method) inheritance. If you try to call a method on an object
or class, and that method is not found in that objects package, Perl
then looks to @ISA for other packages to go looking through in search
of the missing method.
Like the special per-package variables recognized by Exporter (such as
@EXPORT, @EXPORT_OK, @EXPORT_FAIL, %EXPORT_TAGS, and $VERSION), the
@ISA array must be a package-scoped global and not a file-scoped lexi
cal created via my(). Most classes have just one item in their @ISA
array. In this case, we have whats called "single inheritance", or SI
for short.
Consider this class:
package Employee;
use Person;
@ISA = ("Person");
1;
Not a lot to it, eh? All its doing so far is loading in another class
and stating that this one will inherit methods from that other class if
need be. We have given it none of its own methods. We rely upon an
Employee to behave just like a Person.
Setting up an empty class like this is called the "empty subclass
test"; that is, making a derived class that does nothing but inherit
from a base class. If the original base class has been designed prop
erly, then the new derived class can be used as a drop-in replacement
for the old one. This means you should be able to write a program like
this:
use Employee;
my $empl = Employee->new();
$empl->name("Jason");
$empl->age(23);
printf "%s is age %d.\n", $empl->name, $empl->age;
By proper design, we mean always using the two-argument form of
bless(), avoiding direct access of global data, and not exporting any
thing. If you look back at the Person::new() function we defined
above, we were careful to do that. Theres a bit of package data used
in the constructor, but the reference to this is stored on the object
itself and all other methods access package data via that reference, so
we should be ok.
What do we mean by the Person::new() function -- isnt that actually a
method? Well, in principle, yes. A method is just a function that
expects as its first argument a class name (package) or object (blessed
reference). Person::new() is the function that both the "Per
son->new()" method and the "Employee->new()" method end up calling.
Understand that while a method call looks a lot like a function call,
they arent really quite the same, and if you treat them as the same,
youll very soon be left with nothing but broken programs. First, the
actual underlying calling conventions are different: method calls get
an extra argument. Second, function calls dont do inheritance, but
methods do.
Method Call Resulting Function Call
----------- ------------------------
Person->new() Person::new("Person")
Employee->new() Person::new("Employee")
So dont use function calls when you mean to call a method.
If an employee is just a Person, thats not all too very interesting.
So lets add some other methods. Well give our employee data fields
to access their salary, their employee ID, and their start date.
If youre getting a little tired of creating all these nearly identical
methods just to get at the objects data, do not despair. Later, well
describe several different convenience mechanisms for shortening this
up. Meanwhile, heres the straight-forward way:
sub salary {
my $self = shift;
if (@_) { $self->{SALARY} = shift }
return $self->{SALARY};
}
sub id_number {
my $self = shift;
if (@_) { $self->{ID} = shift }
return $self->{ID};
}
sub start_date {
my $self = shift;
if (@_) { $self->{START_DATE} = shift }
return $self->{START_DATE};
}
Overridden Methods
What happens when both a derived class and its base class have the same
method defined? Well, then you get the derived classs version of that
method. For example, lets say that we want the peers() method called
on an employee to act a bit differently. Instead of just returning the
list of peer names, lets return slightly different strings. So doing
this:
$empl->peers("Peter", "Paul", "Mary");
printf "His peers are: %s\n", join(", ", $empl->peers);
will produce:
His peers are: PEON=PETER, PEON=PAUL, PEON=MARY
To do this, merely add this definition into the Employee.pm file:
sub peers {
my $self = shift;
if (@_) { @{ $self->{PEERS} } = @_ }
return map { "PEON=\U$_" } @{ $self->{PEERS} };
}
There, weve just demonstrated the high-falutin concept known in cer
tain circles as polymorphism. Weve taken on the form and behaviour of
an existing object, and then weve altered it to suit our own purposes.
This is a form of Laziness. (Getting polymorphed is also what happens
when the wizard decides youd look better as a frog.)
Every now and then youll want to have a method call trigger both its
derived class (also known as "subclass") version as well as its base
class (also known as "superclass") version. In practice, constructors
and destructors are likely to want to do this, and it probably also
makes sense in the debug() method we showed previously.
To do this, add this to Employee.pm:
use Carp;
my $Debugging = 0;
sub debug {
my $self = shift;
confess "usage: thing->debug(level)" unless @_ == 1;
my $level = shift;
if (ref($self)) {
$self->{"_DEBUG"} = $level;
} else {
$Debugging = $level; # whole class
}
Person::debug($self, $Debugging); # dont really do this
}
As you see, we turn around and call the Person packages debug() func
tion. But this is far too fragile for good design. What if Person
doesnt have a debug() function, but is inheriting its debug() method
from elsewhere? It would have been slightly better to say
Person->debug($Debugging);
But even thats got too much hard-coded. Its somewhat better to say
$self->Person::debug($Debugging);
Which is a funny way to say to start looking for a debug() method up in
Person. This strategy is more often seen on overridden object methods
than on overridden class methods.
There is still something a bit off here. Weve hard-coded our
superclasss name. This in particular is bad if you change which
classes you inherit from, or add others. Fortunately, the pseudoclass
SUPER comes to the rescue here.
$self->SUPER::debug($Debugging);
This way it starts looking in my classs @ISA. This only makes sense
from within a method call, though. Dont try to access anything in
SUPER:: from anywhere else, because it doesnt exist outside an over
ridden method call. Note that "SUPER" refers to the superclass of the
current package, not to the superclass of $self.
Things are getting a bit complicated here. Have we done anything we
shouldnt? As before, one way to test whether were designing a decent
class is via the empty subclass test. Since we already have an
Employee class that were trying to check, wed better get a new empty
subclass that can derive from Employee. Heres one:
package Boss;
use Employee; # :-)
@ISA = qw(Employee);
And heres the test program:
#!/usr/bin/perl -w
use strict;
use Boss;
Boss->debug(1);
my $boss = Boss->new();
$boss->fullname->title("Don");
$boss->fullname->surname("Pichon Alvarez");
$boss->fullname->christian("Federico Jesus");
$boss->fullname->nickname("Fred");
$boss->age(47);
$boss->peers("Frank", "Felipe", "Faust");
printf "%s is age %d.\n", $boss->fullname->as_string, $boss->age;
printf "His peers are: %s\n", join(", ", $boss->peers);
Running it, we see that were still ok. If youd like to dump out your
object in a nice format, somewhat like the way the x command works in
the debugger, you could use the Data::Dumper module from CPAN this way:
use Data::Dumper;
print "Heres the boss:\n";
print Dumper($boss);
Which shows us something like this:
Heres the boss:
$VAR1 = bless( {
_CENSUS => \1,
FULLNAME => bless( {
TITLE => Don,
SURNAME => Pichon Alvarez,
NICK => Fred,
CHRISTIAN => Federico Jesus
}, Fullname ),
AGE => 47,
PEERS => [
Frank,
Felipe,
Faust
]
}, Boss );
Hm.... somethings missing there. What about the salary, start date,
and ID fields? Well, we never set them to anything, even undef, so
they dont show up in the hashs keys. The Employee class has no new()
method of its own, and the new() method in Person doesnt know about
Employees. (Nor should it: proper OO design dictates that a subclass
be allowed to know about its immediate superclass, but never
vice-versa.) So lets fix up Employee::new() this way:
sub new {
my $class = shift;
my $self = $class->SUPER::new();
$self->{SALARY} = undef;
$self->{ID} = undef;
$self->{START_DATE} = undef;
bless ($self, $class); # reconsecrate
return $self;
}
Now if you dump out an Employee or Boss object, youll find that new
fields show up there now.
Multiple Inheritance
Ok, at the risk of confusing beginners and annoying OO gurus, its time
to confess that Perls object system includes that controversial notion
known as multiple inheritance, or MI for short. All this means is that
rather than having just one parent class who in turn might itself have
a parent class, etc., that you can directly inherit from two or more
parents. Its true that some uses of MI can get you into trouble,
although hopefully not quite so much trouble with Perl as with dubi
ously-OO languages like C++.
The way it works is actually pretty simple: just put more than one
package name in your @ISA array. When it comes time for Perl to go
finding methods for your object, it looks at each of these packages in
order. Well, kinda. Its actually a fully recursive, depth-first
order. Consider a bunch of @ISA arrays like this:
@First::ISA = qw( Alpha );
@Second::ISA = qw( Beta );
@Third::ISA = qw( First Second );
If you have an object of class Third:
my $ob = Third->new();
$ob->spin();
How do we find a spin() method (or a new() method for that matter)?
Because the search is depth-first, classes will be looked up in the
following order: Third, First, Alpha, Second, and Beta.
In practice, few class modules have been seen that actually make use of
MI. One nearly always chooses simple containership of one class within
another over MI. Thats why our Person object contained a Fullname
object. That doesnt mean it was one.
However, there is one particular area where MI in Perl is rampant: bor
rowing another classs class methods. This is rather common, espe
cially with some bundled "objectless" classes, like Exporter,
DynaLoader, AutoLoader, and SelfLoader. These classes do not provide
constructors; they exist only so you may inherit their class methods.
(Its not entirely clear why inheritance was done here rather than tra
ditional module importation.)
For example, here is the POSIX modules @ISA:
package POSIX;
@ISA = qw(Exporter DynaLoader);
The POSIX module isnt really an object module, but then, neither are
Exporter or DynaLoader. Theyre just lending their classes behaviours
to POSIX.
Why dont people use MI for object methods much? One reason is that it
can have complicated side-effects. For one thing, your inheritance
graph (no longer a tree) might converge back to the same base class.
Although Perl guards against recursive inheritance, merely having par
ents who are related to each other via a common ancestor, incestuous
though it sounds, is not forbidden. What if in our Third class shown
above we wanted its new() method to also call both overridden construc
tors in its two parent classes? The SUPER notation would only find the
first one. Also, what about if the Alpha and Beta classes both had a
common ancestor, like Nought? If you kept climbing up the inheritance
tree calling overridden methods, youd end up calling Nought::new()
twice, which might well be a bad idea.
UNIVERSAL: The Root of All Objects
Wouldnt it be convenient if all objects were rooted at some ultimate
base class? That way you could give every object common methods with
out having to go and add it to each and every @ISA. Well, it turns out
that you can. You dont see it, but Perl tacitly and irrevocably
assumes that theres an extra element at the end of @ISA: the class
UNIVERSAL. In version 5.003, there were no predefined methods there,
but you could put whatever you felt like into it.
However, as of version 5.004 (or some subversive releases, like
5.003_08), UNIVERSAL has some methods in it already. These are builtin
to your Perl binary, so they dont take any extra time to load. Prede
fined methods include isa(), can(), and VERSION(). isa() tells you
whether an object or class "is" another one without having to traverse
the hierarchy yourself:
$has_io = $fd->isa("IO::Handle");
$itza_handle = IO::Socket->isa("IO::Handle");
The can() method, called against that object or class, reports back
whether its string argument is a callable method name in that class.
In fact, it gives you back a function reference to that method:
$his_print_method = $obj->can(as_string);
Finally, the VERSION method checks whether the class (or the objects
class) has a package global called $VERSION thats high enough, as in:
Some_Module->VERSION(3.0);
$his_vers = $ob->VERSION();
However, we dont usually call VERSION ourselves. (Remember that an
all uppercase function name is a Perl convention that indicates that
the function will be automatically used by Perl in some way.) In this
case, it happens when you say
use Some_Module 3.0;
If you wanted to add version checking to your Person class explained
above, just add this to Person.pm:
our $VERSION = 1.1;
and then in Employee.pm you can say
use Person 1.1;
And it would make sure that you have at least that version number or
higher available. This is not the same as loading in that exact ver
sion number. No mechanism currently exists for concurrent installation
of multiple versions of a module. Lamentably.
Alternate Object Representations
Nothing requires objects to be implemented as hash references. An
object can be any sort of reference so long as its referent has been
suitably blessed. That means scalar, array, and code references are
also fair game.
A scalar would work if the object has only one datum to hold. An array
would work for most cases, but makes inheritance a bit dodgy because
you have to invent new indices for the derived classes.
Arrays as Objects
If the user of your class honors the contract and sticks to the adver
tised interface, then you can change its underlying interface if you
feel like it. Heres another implementation that conforms to the same
interface specification. This time well use an array reference
instead of a hash reference to represent the object.
package Person;
use strict;
my($NAME, $AGE, $PEERS) = ( 0 .. 2 );
############################################
## the object constructor (array version) ##
############################################
sub new {
my $self = [];
$self->[$NAME] = undef; # this is unnecessary
$self->[$AGE] = undef; # as is this
$self->[$PEERS] = []; # but this isnt, really
bless($self);
return $self;
}
sub name {
my $self = shift;
if (@_) { $self->[$NAME] = shift }
return $self->[$NAME];
}
sub age {
my $self = shift;
if (@_) { $self->[$AGE] = shift }
return $self->[$AGE];
}
sub peers {
my $self = shift;
if (@_) { @{ $self->[$PEERS] } = @_ }
return @{ $self->[$PEERS] };
}
1; # so the require or use succeeds
You might guess that the array access would be a lot faster than the
hash access, but theyre actually comparable. The array is a little
bit faster, but not more than ten or fifteen percent, even when you
replace the variables above like $AGE with literal numbers, like 1. A
bigger difference between the two approaches can be found in memory
use. A hash representation takes up more memory than an array repre
sentation because you have to allocate memory for the keys as well as
for the values. However, it really isnt that bad, especially since as
of version 5.004, memory is only allocated once for a given hash key,
no matter how many hashes have that key. Its expected that sometime
in the future, even these differences will fade into obscurity as more
efficient underlying representations are devised.
Still, the tiny edge in speed (and somewhat larger one in memory) is
enough to make some programmers choose an array representation for sim
ple classes. Theres still a little problem with scalability, though,
because later in life when you feel like creating subclasses, youll
find that hashes just work out better.
Closures as Objects
Using a code reference to represent an object offers some fascinating
possibilities. We can create a new anonymous function (closure) who
alone in all the world can see the objects data. This is because we
put the data into an anonymous hash thats lexically visible only to
the closure we create, bless, and return as the object. This objects
methods turn around and call the closure as a regular subroutine call,
passing it the field we want to affect. (Yes, the double-function call
is slow, but if you wanted fast, you wouldnt be using objects at all,
eh? :-)
Use would be similar to before:
use Person;
$him = Person->new();
$him->name("Jason");
$him->age(23);
$him->peers( [ "Norbert", "Rhys", "Phineas" ] );
printf "%s is %d years old.\n", $him->name, $him->age;
print "His peers are: ", join(", ", @{$him->peers}), "\n";
but the implementation would be radically, perhaps even sublimely dif
ferent:
package Person;
sub new {
my $class = shift;
my $self = {
NAME => undef,
AGE => undef,
PEERS => [],
};
my $closure = sub {
my $field = shift;
if (@_) { $self->{$field} = shift }
return $self->{$field};
};
bless($closure, $class);
return $closure;
}
sub name { &{ $_[0] }("NAME", @_[ 1 .. $#_ ] ) }
sub age { &{ $_[0] }("AGE", @_[ 1 .. $#_ ] ) }
sub peers { &{ $_[0] }("PEERS", @_[ 1 .. $#_ ] ) }
1;
Because this object is hidden behind a code reference, its probably a
bit mysterious to those whose background is more firmly rooted in stan
dard procedural or object-based programming languages than in func
tional programming languages whence closures derive. The object cre
ated and returned by the new() method is itself not a data reference as
weve seen before. Its an anonymous code reference that has within it
access to a specific version (lexical binding and instantiation) of the
objects data, which are stored in the private variable $self.
Although this is the same function each time, it contains a different
version of $self.
When a method like "$him->name("Jason")" is called, its implicit zeroth
argument is the invoking object--just as it is with all method calls.
But in this case, its our code reference (something like a function
pointer in C++, but with deep binding of lexical variables). Theres
not a lot to be done with a code reference beyond calling it, so thats
just what we do when we say "&{$_[0]}". This is just a regular func
tion call, not a method call. The initial argument is the string
"NAME", and any remaining arguments are whatever had been passed to the
method itself.
Once were executing inside the closure that had been created in new(),
the $self hash reference suddenly becomes visible. The closure grabs
its first argument ("NAME" in this case because thats what the name()
method passed it), and uses that string to subscript into the private
hash hidden in its unique version of $self.
Nothing under the sun will allow anyone outside the executing method to
be able to get at this hidden data. Well, nearly nothing. You could
single step through the program using the debugger and find out the
pieces while youre in the method, but everyone else is out of luck.
There, if that doesnt excite the Scheme folks, then I just dont know
what will. Translation of this technique into C++, Java, or any other
braindead-static language is left as a futile exercise for aficionados
of those camps.
You could even add a bit of nosiness via the caller() function and make
the closure refuse to operate unless called via its own package. This
would no doubt satisfy certain fastidious concerns of programming
police and related puritans.
If you were wondering when Hubris, the third principle virtue of a pro
grammer, would come into play, here you have it. (More seriously,
Hubris is just the pride in craftsmanship that comes from having writ
ten a sound bit of well-designed code.)
AUTOLOAD: Proxy Methods
Autoloading is a way to intercept calls to undefined methods. An
autoload routine may choose to create a new function on the fly, either
loaded from disk or perhaps just eval()ed right there. This define-on-
the-fly strategy is why its called autoloading.
But thats only one possible approach. Another one is to just have the
autoloaded method itself directly provide the requested service. When
used in this way, you may think of autoloaded methods as "proxy" meth
ods.
When Perl tries to call an undefined function in a particular package
and that function is not defined, it looks for a function in that same
package called AUTOLOAD. If one exists, its called with the same
arguments as the original function would have had. The fully-qualified
name of the function is stored in that packages global variable
$AUTOLOAD. Once called, the function can do anything it would like,
including defining a new function by the right name, and then doing a
really fancy kind of "goto" right to it, erasing itself from the call
stack.
What does this have to do with objects? After all, we keep talking
about functions, not methods. Well, since a method is just a function
with an extra argument and some fancier semantics about where its
found, we can use autoloading for methods, too. Perl doesnt start
looking for an AUTOLOAD method until it has exhausted the recursive
hunt up through @ISA, though. Some programmers have even been known to
define a UNIVERSAL::AUTOLOAD method to trap unresolved method calls to
any kind of object.
Autoloaded Data Methods
You probably began to get a little suspicious about the duplicated code
way back earlier when we first showed you the Person class, and then
later the Employee class. Each method used to access the hash fields
looked virtually identical. This should have tickled that great pro
gramming virtue, Impatience, but for the time, we let Laziness win out,
and so did nothing. Proxy methods can cure this.
Instead of writing a new function every time we want a new data field,
well use the autoload mechanism to generate (actually, mimic) methods
on the fly. To verify that were accessing a valid member, we will
check against an "_permitted" (pronounced "under-permitted") field,
which is a reference to a file-scoped lexical (like a C file static)
hash of permitted fields in this record called %fields. Why the under
score? For the same reason as the _CENSUS field we once used: as a
marker that means "for internal use only".
Heres what the module initialization code and class constructor will
look like when taking this approach:
package Person;
use Carp;
our $AUTOLOAD; # its a package global
my %fields = (
name => undef,
age => undef,
peers => undef,
);
sub new {
my $class = shift;
my $self = {
_permitted => \%fields,
%fields,
};
bless $self, $class;
return $self;
}
If we wanted our record to have default values, we could fill those in
where current we have "undef" in the %fields hash.
Notice how we saved a reference to our class data on the object itself?
Remember that its important to access class data through the object
itself instead of having any method reference %fields directly, or else
you wont have a decent inheritance.
The real magic, though, is going to reside in our proxy method, which
will handle all calls to undefined methods for objects of class Person
(or subclasses of Person). It has to be called AUTOLOAD. Again, its
all caps because its called for us implicitly by Perl itself, not by a
user directly.
sub AUTOLOAD {
my $self = shift;
my $type = ref($self)
or croak "$self is not an object";
my $name = $AUTOLOAD;
$name =~ s/.*://; # strip fully-qualified portion
unless (exists $self->{_permitted}->{$name} ) {
croak "Cant access $name field in class $type";
}
if (@_) {
return $self->{$name} = shift;
} else {
return $self->{$name};
}
}
Pretty nifty, eh? All we have to do to add new data fields is modify
%fields. No new functions need be written.
I could have avoided the "_permitted" field entirely, but I wanted to
demonstrate how to store a reference to class data on the object so you
wouldnt have to access that class data directly from an object method.
Inherited Autoloaded Data Methods
But what about inheritance? Can we define our Employee class simi
larly? Yes, so long as were careful enough.
Heres how to be careful:
package Employee;
use Person;
use strict;
our @ISA = qw(Person);
my %fields = (
id => undef,
salary => undef,
);
sub new {
my $class = shift;
my $self = $class->SUPER::new();
my($element);
foreach $element (keys %fields) {
$self->{_permitted}->{$element} = $fields{$element};
}
@{$self}{keys %fields} = values %fields;
return $self;
}
Once weve done this, we dont even need to have an AUTOLOAD function
in the Employee package, because well grab Persons version of that
via inheritance, and it will all work out just fine.
Metaclassical Tools
Even though proxy methods can provide a more convenient approach to
making more struct-like classes than tediously coding up data methods
as functions, it still leaves a bit to be desired. For one thing, it
means you have to handle bogus calls that you dont mean to trap via
your proxy. It also means you have to be quite careful when dealing
with inheritance, as detailed above.
Perl programmers have responded to this by creating several different
class construction classes. These metaclasses are classes that create
other classes. A couple worth looking at are Class::Struct and Alias.
These and other related metaclasses can be found in the modules direc
tory on CPAN.
Class::Struct
One of the older ones is Class::Struct. In fact, its syntax and inter
face were sketched out long before perl5 even solidified into a real
thing. What it does is provide you a way to "declare" a class as hav
ing objects whose fields are of a specific type. The function that
does this is called, not surprisingly enough, struct(). Because struc
tures or records are not base types in Perl, each time you want to cre
ate a class to provide a record-like data object, you yourself have to
define a new() method, plus separate data-access methods for each of
that records fields. Youll quickly become bored with this process.
The Class::Struct::struct() function alleviates this tedium.
Heres a simple example of using it:
use Class::Struct qw(struct);
use Jobbie; # user-defined; see below
struct Fred => {
one => $,
many => @,
profession => Jobbie, # does not call Jobbie->new()
};
$ob = Fred->new(profession => Jobbie->new());
$ob->one("hmmmm");
$ob->many(0, "here");
$ob->many(1, "you");
$ob->many(2, "go");
print "Just set: ", $ob->many(2), "\n";
$ob->profession->salary(10_000);
You can declare types in the struct to be basic Perl types, or user-
defined types (classes). User types will be initialized by calling
that classs new() method.
Take care that the "Jobbie" object is not created automatically by the
"Fred" classs new() method, so you should specify a "Jobbie" object
when you create an instance of "Fred".
Heres a real-world example of using struct generation. Lets say you
wanted to override Perls idea of gethostbyname() and gethostbyaddr()
so that they would return objects that acted like C structures. We
dont care about high-falutin OO gunk. All we want is for these
objects to act like structs in the C sense.
use Socket;
use Net::hostent;
$h = gethostbyname("perl.com"); # object return
printf "perl.coms real name is %s, address %s\n",
$h->name, inet_ntoa($h->addr);
Heres how to do this using the Class::Struct module. The crux is
going to be this call:
struct Net::hostent => [ # note bracket
name => $,
aliases => @,
addrtype => $,
length => $,
addr_list => @,
];
Which creates object methods of those names and types. It even creates
a new() method for us.
We could also have implemented our object this way:
struct Net::hostent => { # note brace
name => $,
aliases => @,
addrtype => $,
length => $,
addr_list => @,
};
and then Class::Struct would have used an anonymous hash as the object
type, instead of an anonymous array. The array is faster and smaller,
but the hash works out better if you eventually want to do inheritance.
Since for this struct-like object we arent planning on inheritance,
this time well opt for better speed and size over better flexibility.
Heres the whole implementation:
package Net::hostent;
use strict;
BEGIN {
use Exporter ();
our @EXPORT = qw(gethostbyname gethostbyaddr gethost);
our @EXPORT_OK = qw(
$h_name @h_aliases
$h_addrtype $h_length
@h_addr_list $h_addr
);
our %EXPORT_TAGS = ( FIELDS => [ @EXPORT_OK, @EXPORT ] );
}
our @EXPORT_OK;
# Class::Struct forbids use of @ISA
sub import { goto &Exporter::import }
use Class::Struct qw(struct);
struct Net::hostent => [
name => $,
aliases => @,
addrtype => $,
length => $,
addr_list => @,
];
sub addr { shift->addr_list->[0] }
sub populate (@) {
return unless @_;
my $hob = new(); # Class::Struct made this!
$h_name = $hob->[0] = $_[0];
@h_aliases = @{ $hob->[1] } = split , $_[1];
$h_addrtype = $hob->[2] = $_[2];
$h_length = $hob->[3] = $_[3];
$h_addr = $_[4];
@h_addr_list = @{ $hob->[4] } = @_[ (4 .. $#_) ];
return $hob;
}
sub gethostbyname ($) { populate(CORE::gethostbyname(shift)) }
sub gethostbyaddr ($;$) {
my ($addr, $addrtype);
$addr = shift;
require Socket unless @_;
$addrtype = @_ ? shift : Socket::AF_INET();
populate(CORE::gethostbyaddr($addr, $addrtype))
}
sub gethost($) {
if ($_[0] =~ /^\d+(?:\.\d+(?:\.\d+(?:\.\d+)?)?)?$/) {
require Socket;
&gethostbyaddr(Socket::inet_aton(shift));
} else {
&gethostbyname;
}
}
1;
Weve snuck in quite a fair bit of other concepts besides just dynamic
class creation, like overriding core functions, import/export bits,
function prototyping, short-cut function call via &whatever, and func
tion replacement with "goto &whatever". These all mostly make sense
from the perspective of a traditional module, but as you can see, we
can also use them in an object module.
You can look at other object-based, struct-like overrides of core func
tions in the 5.004 release of Perl in File::stat, Net::hostent,
Net::netent, Net::protoent, Net::servent, Time::gmtime, Time::local
time, User::grent, and User::pwent. These modules have a final compo
nent thats all lowercase, by convention reserved for compiler pragmas,
because they affect the compilation and change a builtin function.
They also have the type names that a C programmer would most expect.
Data Members as Variables
If youre used to C++ objects, then youre accustomed to being able to
get at an objects data members as simple variables from within a
method. The Alias module provides for this, as well as a good bit
more, such as the possibility of private methods that the object can
call but folks outside the class cannot.
Heres an example of creating a Person using the Alias module. When
you update these magical instance variables, you automatically update
value fields in the hash. Convenient, eh?
package Person;
# this is the same as before...
sub new {
my $class = shift;
my $self = {
NAME => undef,
AGE => undef,
PEERS => [],
};
bless($self, $class);
return $self;
}
use Alias qw(attr);
our ($NAME, $AGE, $PEERS);
sub name {
my $self = attr shift;
if (@_) { $NAME = shift; }
return $NAME;
}
sub age {
my $self = attr shift;
if (@_) { $AGE = shift; }
return $AGE;
}
sub peers {
my $self = attr shift;
if (@_) { @PEERS = @_; }
return @PEERS;
}
sub exclaim {
my $self = attr shift;
return sprintf "Hi, Im %s, age %d, working with %s",
$NAME, $AGE, join(", ", @PEERS);
}
sub happy_birthday {
my $self = attr shift;
return ++$AGE;
}
The need for the "our" declaration is because what Alias does is play
with package globals with the same name as the fields. To use globals
while "use strict" is in effect, you have to predeclare them. These
package variables are localized to the block enclosing the attr() call
just as if youd used a local() on them. However, that means that
theyre still considered global variables with temporary values, just
as with any other local().
It would be nice to combine Alias with something like Class::Struct or
Class::MethodMaker.
NOTES
Object Terminology
In the various OO literature, it seems that a lot of different words
are used to describe only a few different concepts. If youre not
already an object programmer, then you dont need to worry about all
these fancy words. But if you are, then you might like to know how to
get at the same concepts in Perl.
For example, its common to call an object an instance of a class and
to call those objects methods instance methods. Data fields peculiar
to each object are often called instance data or object attributes, and
data fields common to all members of that class are class data, class
attributes, or static data members.
Also, base class, generic class, and superclass all describe the same
notion, whereas derived class, specific class, and subclass describe
the other related one.
C++ programmers have static methods and virtual methods, but Perl only
has class methods and object methods. Actually, Perl only has methods.
Whether a method gets used as a class or object method is by usage
only. You could accidentally call a class method (one expecting a
string argument) on an object (one expecting a reference), or vice
versa.
From the C++ perspective, all methods in Perl are virtual. This, by
the way, is why they are never checked for function prototypes in the
argument list as regular builtin and user-defined functions can be.
Because a class is itself something of an object, Perls classes can be
taken as describing both a "class as meta-object" (also called object
factory) philosophy and the "class as type definition" (declaring
behaviour, not defining mechanism) idea. C++ supports the latter
notion, but not the former.
SEE ALSO
The following manpages will doubtless provide more background for this
one: perlmod, perlref, perlobj, perlbot, perltie, and overload.
perlboot is a kinder, gentler introduction to object-oriented program
ming.
perltooc provides more detail on class data.
Some modules which might prove interesting are Class::Accessor,
Class::Class, Class::Contract, Class::Data::Inheritable, Class::Method
Maker and Tie::SecureHash
AUTHOR AND COPYRIGHT
Copyright (c) 1997, 1998 Tom Christiansen All rights reserved.
This documentation is free; you can redistribute it and/or modify it
under the same terms as Perl itself.
Irrespective of its distribution, all code examples in this file are
hereby placed into the public domain. You are permitted and encouraged
to use this code in your own programs for fun or for profit as you see
fit. A simple comment in the code giving credit would be courteous but
is not required.
COPYRIGHT
Acknowledgments
Thanks to Larry Wall, Roderick Schertler, Gurusamy Sarathy, Dean
Roehrich, Raphael Manfredi, Brent Halsey, Greg Bacon, Brad Appleton,
and many others for their helpful comments.
perl v5.8.8 2008-04-25 PERLTOOT(1)
|