Manual Reference Pages - EVERY (3)
Every - return true every N cycles or S seconds
print_stats() if every(20); # every 20 cycles
print_times() if every(seconds => 5); # every 5 or more seconds
every( CW$number [, CW@id] )
every( seconds => CW$number [, CW@id] )
Returns true every $number times its called, or every time $number
seconds have elapsed since the last time it was called.
The every() function keeps track of where it was called by line, even
if you call it twice on the same line, e.g.
print "hello" if every(5) or every(6);
The every() function will use the Devel::Callsite module to find the
opcode and interpreter context (both unique numbers).
The optional @id is a list of arguments that compose a unique identifier.
In other words, every(100, x) will run its 100 cycles independently of
every(100, x, y).
Returns true when the conditions (cycles or seconds elapsed) are met.
The first cycle doesnt count (so e.g. every(100) will be true at
100, 200, etc.)
Thanks to Dr.Ruud on comp.lang.perl.misc for helping with this idea,
and to Jerry Hedden for cleaning it up. Thanks to Ben Morrow for
getting Devel::Callsite started, which module is essential to Every.
Thanks to Jerrad Pierce and ikegami for the bug reports and help.
Copyright 2008, Ted Zlatanov (XXXXXX XXXXXXXX). All Rights
Reserved. This module can be redistributed under the same terms as
Ted Zlatanov <firstname.lastname@example.org>
|perl v5.20.3 ||EVERY (3) ||2010-04-01 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.