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

Comparing EV/EV.pm (file contents):
Revision 1.140 by root, Wed Apr 3 23:47:06 2013 UTC vs.
Revision 1.148 by root, Sun Dec 20 01:35:46 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.15'; 124 our $VERSION = 4.22;
125 use XSLoader; 125 use XSLoader;
126 local $^W = 0; # avoid spurious warning 126 local $^W = 0; # avoid spurious warning
127 XSLoader::load "EV", $VERSION; 127 XSLoader::load "EV", $VERSION;
128} 128}
129 129
… …
296=item $active = EV::run [$flags] 296=item $active = EV::run [$flags]
297 297
298=item $active = $loop->run ([$flags]) 298=item $active = $loop->run ([$flags])
299 299
300Begin checking for events and calling callbacks. It returns when a 300Begin checking for events and calling callbacks. It returns when a
301callback 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
302return 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
303the 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
304false. 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
305more work left to do". 305more work left to do".
306 306
… …
614in 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
615clock, the timer will nevertheless run (roughly) the same time. 615clock, the timer will nevertheless run (roughly) the same time.
616 616
617The 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.
618 618
619=item $w->set ($after, $repeat) 619=item $w->set ($after, $repeat = 0)
620 620
621Reconfigures 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
622any time. 622any time.
623 623
624=item $w->again 624=item $w->again
625
626=item $w->again ($repeat)
625 627
626Similar 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:
627 629
628If the timer is active and non-repeating, it will be stopped. 630If the timer is active and non-repeating, it will be stopped.
629 631
… …
636 638
637This behaviour is useful when you have a timeout for some IO 639This behaviour is useful when you have a timeout for some IO
638operation. 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
639C<$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
640on 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.
641 650
642=back 651=back
643 652
644 653
645=head3 PERIODIC WATCHERS - to cron or not to cron? 654=head3 PERIODIC WATCHERS - to cron or not to cron?
… …
682time: 691time:
683 692
684 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" };
685 694
686That 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,
687but 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
688full hour (UTC). 697full hour (UTC).
689 698
690Another way to think about it (for the mathematically inclined) is that 699Another way to think about it (for the mathematically inclined) is that
691EV::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
692possible 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