NAME¶
Acme::POE::Knee - Time sliced pony race using the POE kernel.
REQUIREMENTS¶
Acme::POE::Knee requires the POE module to run. You can get that as well
from CPAN or look at poe.sourceforge.net
SYNOPSIS¶
#!/usr/bin/perl -w
use strict;
# Use POEny!
use Acme::POE::Knee;
# Every Acme::POE::Knee race will require a set of arguments.
# There are defaults but it's just more fun to set these
# yourselves. We set a distance the ponies must run and of course
# we name our race ponies! You'll have to specify the maximum
# delay a pony can have before reaching the next stage.
# The lower the delay, the higher the chances are the pony will
# win the race.
my $pony = new Acme::POE::Knee (
dist => 20,
ponies => {
'dngor' => 5,
'Abigail' => 5.2,
'Co-Kane' => 5.4,
'MJD' => 5.6,
'acme' => 5.8,
},
);
# start the race
$pony->race( );
exit;
QUICK LINKS¶
Please see the samples directory in POE's distribution for several
well-commented sample and tutorial programs.
Please see <
http://www.perl.com/pub/2001/01/poe.html> for an excellent,
and more importantly: gradual, introduction to POE.
DESCRIPTION¶
POE::Knee is an acronym of "Pony". We all like ponies. And wouldn't we
love to race ponies? Well, that's what Acme::POE::Knee is for!
It's great for those friday afternoons at the office, where you wonder who will
pay the beer tab. Whoever 'wins' the race, loses!
You specify a distance the ponies must run, and a maximum delay before the pony
will reach the next step. So, the bigger the delay, the bigger the distance
between multiple ponies can be.
Of course this wouldn't be any fun if we couldn't name the ponies ourselves.
Here, we simply put all our race ponies in an array reference and the
Acme::POE::Knee module will take care of the rest.
USING Acme::POE::Knee¶
Using Acme::POE::Knee is really easy. This simple progam would already suffice:
use strict;
use Acme::POE::Knee;
my $pony = new Acme::POE::Knee;
$pony->race();
exit;
This will use the defaults of the POE::Knee module, but you can of course
specify your own arguments, as shown in the synopsis.
The Use of Acme::POE::Knee¶
Use, yes... Usefull? Probably not. This was written in responce to a rather
persistant meme on #perl (you know who you are!). Basicly, we all wanted
ponies. Well folks, here it is.
It's source might be interesting to look at for newcomers to POE to see how this
time slicing works.
Learning more about POE¶
- The POE Mailing List
- POE has a mailing list at perl.org. You can receive
subscription information by sending e-mail:
To: poe-help@perl.org
Subject: (anything will do)
The message body is ignored.
All forms of feedback are welcome.
- The POE Web Site
- POE has a web site where the latest development snapshot,
along with the Changes file and other stuff may be found:
<http://poe.perl.org/>
- SourceForge
- POE's development has moved to SourceForge as an experiment
in project management. You can reach POE's project summary page at
<http://sourceforge.net/projects/poe/>.
Author¶
- Jos Boumans
- Jos Boumans is <kane_at_cpan.org>. POE::Knee is his
brainchild.
- Rocco Caputo
- Rocco Caputo is <troc+poe@netrus.net>. POE itself is
his creation.
COPYRIGHT¶
Copyright (c) 2001, Jos Boumans. All Rights Reserved. This module is free
software. It may be used, redistributed and/or modified under the terms of the
Perl Artistic License (see
http://www.perl.com/perl/misc/Artistic.html)
Except where otherwise noted, POE is Copyright 1998-2001 Rocco Caputo. All
rights reserved. POE is free software; you may redistribute it and/or modify
it under the same terms as Perl itself.