ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/EV/EV.pm
(Generate patch)

Comparing EV/EV.pm (file contents):
Revision 1.138 by root, Sun May 6 16:30:27 2012 UTC vs.
Revision 1.147 by root, Mon Jul 13 19:47:53 2015 UTC

… …
47 my ($w, $revents) = @_; 47 my ($w, $revents) = @_;
48 warn $w->path, " has changed somehow.\n"; 48 warn $w->path, " has changed somehow.\n";
49 }; 49 };
50 50
51 # MAINLOOP 51 # MAINLOOP
52 EV::run; # loop until EV::unloop is called or all watchers stop 52 EV::run; # loop until EV::break is called or all watchers stop
53 EV::run EV::RUN_ONCE; # block until at least one event could be handled 53 EV::run EV::RUN_ONCE; # block until at least one event could be handled
54 EV::run EV::RUN_NOWAIT; # try to handle same events, but do not block 54 EV::run EV::RUN_NOWAIT; # try to handle same events, but do not block
55 55
56=head1 BEFORE YOU START USING THIS MODULE 56=head1 BEFORE YOU START USING THIS MODULE
57 57
… …
119package EV; 119package EV;
120 120
121use common::sense; 121use common::sense;
122 122
123BEGIN { 123BEGIN {
124 our $VERSION = '4.11'; 124 our $VERSION = 4.21;
125 use XSLoader; 125 use XSLoader;
126 local $^W = 0; # avoid spurious warning
126 XSLoader::load "EV", $VERSION; 127 XSLoader::load "EV", $VERSION;
127} 128}
128 129
129@EV::IO::ISA = 130@EV::IO::ISA =
130@EV::Timer::ISA = 131@EV::Timer::ISA =
… …
295=item $active = EV::run [$flags] 296=item $active = EV::run [$flags]
296 297
297=item $active = $loop->run ([$flags]) 298=item $active = $loop->run ([$flags])
298 299
299Begin checking for events and calling callbacks. It returns when a 300Begin checking for events and calling callbacks. It returns when a
300callback calls EV::unloop or the flasg are nonzero (in which case the 301callback calls EV::break or the flasg are nonzero (in which case the
301return value is true) or when there are no active watchers which reference 302return value is true) or when there are no active watchers which reference
302the loop (keepalive is true), in which case the return value will be 303the loop (keepalive is true), in which case the return value will be
303false. The returnv alue can generally be interpreted as "if true, there is 304false. The returnv alue can generally be interpreted as "if true, there is
304more work left to do". 305more work left to do".
305 306
… …
613in front of the machine while the timer is running and changes the system 614in front of the machine while the timer is running and changes the system
614clock, the timer will nevertheless run (roughly) the same time. 615clock, the timer will nevertheless run (roughly) the same time.
615 616
616The C<timer_ns> variant doesn't start (activate) the newly created watcher. 617The C<timer_ns> variant doesn't start (activate) the newly created watcher.
617 618
618=item $w->set ($after, $repeat) 619=item $w->set ($after, $repeat = 0)
619 620
620Reconfigures the watcher, see the constructor above for details. Can be called at 621Reconfigures the watcher, see the constructor above for details. Can be called at
621any time. 622any time.
622 623
623=item $w->again 624=item $w->again
625
626=item $w->again ($repeat)
624 627
625Similar to the C<start> method, but has special semantics for repeating timers: 628Similar to the C<start> method, but has special semantics for repeating timers:
626 629
627If the timer is active and non-repeating, it will be stopped. 630If the timer is active and non-repeating, it will be stopped.
628 631
… …
635 638
636This behaviour is useful when you have a timeout for some IO 639This behaviour is useful when you have a timeout for some IO
637operation. You create a timer object with the same value for C<$after> and 640operation. You create a timer object with the same value for C<$after> and
638C<$repeat>, and then, in the read/write watcher, run the C<again> method 641C<$repeat>, and then, in the read/write watcher, run the C<again> method
639on the timeout. 642on the timeout.
643
644If called with a C<$repeat> argument, then it uses this a timer repeat
645value.
646
647=item $after = $w->remaining
648
649Calculates and returns the remaining time till the timer will fire.
640 650
641=back 651=back
642 652
643 653
644=head3 PERIODIC WATCHERS - to cron or not to cron? 654=head3 PERIODIC WATCHERS - to cron or not to cron?
… …
681time: 691time:
682 692
683 my $hourly = EV::periodic 0, 3600, 0, sub { print "once/hour\n" }; 693 my $hourly = EV::periodic 0, 3600, 0, sub { print "once/hour\n" };
684 694
685That doesn't mean there will always be 3600 seconds in between triggers, 695That doesn't mean there will always be 3600 seconds in between triggers,
686but only that the the clalback will be called when the system time shows a 696but only that the the callback will be called when the system time shows a
687full hour (UTC). 697full hour (UTC).
688 698
689Another way to think about it (for the mathematically inclined) is that 699Another way to think about it (for the mathematically inclined) is that
690EV::periodic will try to run the callback in this mode at the next 700EV::periodic will try to run the callback in this mode at the next
691possible time where C<$time = $at (mod $interval)>, regardless of any time 701possible time where C<$time = $at (mod $interval)>, regardless of any time

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines