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

Comparing EV/EV.pm (file contents):
Revision 1.36 by root, Sun Nov 11 04:14:09 2007 UTC vs.
Revision 1.40 by root, Fri Nov 16 05:04:36 2007 UTC

… …
41 my ($w, $revents) = @_; 41 my ($w, $revents) = @_;
42 my $status = $w->rstatus; 42 my $status = $w->rstatus;
43 }; 43 };
44 44
45 # MAINLOOP 45 # MAINLOOP
46 EV::loop; # loop until EV::loop_done is called or all watchers stop 46 EV::loop; # loop until EV::unloop is called or all watchers stop
47 EV::loop EV::LOOP_ONESHOT; # block until at least one event could be handled 47 EV::loop EV::LOOP_ONESHOT; # block until at least one event could be handled
48 EV::loop EV::LOOP_NONBLOCK; # try to handle same events, but do not block 48 EV::loop EV::LOOP_NONBLOCK; # try to handle same events, but do not block
49 49
50=head1 DESCRIPTION 50=head1 DESCRIPTION
51 51
… …
57package EV; 57package EV;
58 58
59use strict; 59use strict;
60 60
61BEGIN { 61BEGIN {
62 our $VERSION = '0.8'; 62 our $VERSION = '0.9';
63 use XSLoader; 63 use XSLoader;
64 XSLoader::load "EV", $VERSION; 64 XSLoader::load "EV", $VERSION;
65} 65}
66 66
67@EV::Io::ISA = 67@EV::Io::ISA =
… …
101or EV::METHOD_EPOLL). 101or EV::METHOD_EPOLL).
102 102
103=item EV::loop [$flags] 103=item EV::loop [$flags]
104 104
105Begin checking for events and calling callbacks. It returns when a 105Begin checking for events and calling callbacks. It returns when a
106callback calls EV::loop_done. 106callback calls EV::unloop.
107 107
108The $flags argument can be one of the following: 108The $flags argument can be one of the following:
109 109
110 0 as above 110 0 as above
111 EV::LOOP_ONESHOT block at most once (wait, but do not loop) 111 EV::LOOP_ONESHOT block at most once (wait, but do not loop)
112 EV::LOOP_NONBLOCK do not block at all (fetch/handle events but do not wait) 112 EV::LOOP_NONBLOCK do not block at all (fetch/handle events but do not wait)
113 113
114=item EV::loop_done [$how] 114=item EV::unloop [$how]
115 115
116When called with no arguments or an argument of 1, makes the innermost 116When called with no arguments or an argument of EV::UNLOOP_ONE, makes the
117call to EV::loop return. 117innermost call to EV::loop return.
118 118
119When called with an agrument of 2, all calls to EV::loop will return as 119When called with an argument of EV::UNLOOP_ALL, all calls to EV::loop will return as
120fast as possible. 120fast as possible.
121 121
122=back 122=back
123 123
124=head2 WATCHER 124=head2 WATCHER
… …
258Calls the callback after C<$after> seconds. If C<$repeat> is non-zero, 258Calls the callback after C<$after> seconds. If C<$repeat> is non-zero,
259the timer will be restarted (with the $repeat value as $after) after the 259the timer will be restarted (with the $repeat value as $after) after the
260callback returns. 260callback returns.
261 261
262This means that the callback would be called roughly after C<$after> 262This means that the callback would be called roughly after C<$after>
263seconds, and then every C<$repeat> seconds. "Roughly" because the time of 263seconds, and then every C<$repeat> seconds. The timer does his best not
264callback processing is not taken into account, so the timer will slowly 264to drift, but it will not invoke the timer more often then once per event
265drift. If that isn't acceptable, look at EV::periodic. 265loop iteration, and might drift in other cases. If that isn't acceptable,
266look at EV::periodic, which can provide long-term stable timers.
266 267
267The timer is based on a monotonic clock, that is if somebody is sitting 268The timer is based on a monotonic clock, that is, if somebody is sitting
268in front of the machine while the timer is running and changes the system 269in front of the machine while the timer is running and changes the system
269clock, the timer will nevertheless run (roughly) the same time. 270clock, the timer will nevertheless run (roughly) the same time.
270 271
271The C<timer_ns> variant doesn't start (activate) the newly created watcher. 272The C<timer_ns> variant doesn't start (activate) the newly created watcher.
272 273
… …
277 278
278=item $w->again 279=item $w->again
279 280
280Similar to the C<start> method, but has special semantics for repeating timers: 281Similar to the C<start> method, but has special semantics for repeating timers:
281 282
283If the timer is active and non-repeating, it will be stopped.
284
282If the timer is active and repeating, reset the timeout to occur 285If the timer is active and repeating, reset the timeout to occur
283C<$repeat> seconds after now. 286C<$repeat> seconds after now.
284 287
285If the timer is active and non-repeating, it will be stopped.
286
287If the timer is in active and repeating, start it. 288If the timer is inactive and repeating, start it using the repeat value.
288 289
289Otherwise do nothing. 290Otherwise do nothing.
290 291
291This behaviour is useful when you have a timeout for some IO 292This behaviour is useful when you have a timeout for some IO
292operation. You create a timer object with the same value for C<$after> and 293operation. You create a timer object with the same value for C<$after> and
… …
336possible time where C<$time = $at (mod $interval)>, regardless of any time 337possible time where C<$time = $at (mod $interval)>, regardless of any time
337jumps. 338jumps.
338 339
339=item * manual reschedule mode ($reschedule_cb = coderef) 340=item * manual reschedule mode ($reschedule_cb = coderef)
340 341
341In this mode $interval and $at are both being ignored. Instead, each time 342In this mode $interval and $at are both being ignored. Instead, each
342the periodic watcher gets scheduled, the first callback ($reschedule_cb) 343time the periodic watcher gets scheduled, the reschedule callback
343will be called with the watcher as first, and the current time as second 344($reschedule_cb) will be called with the watcher as first, and the current
344argument. 345time as second argument.
345 346
346I<This callback MUST NOT stop or destroy this or any other periodic 347I<This callback MUST NOT stop or destroy this or any other periodic
347watcher, ever>. If you need to stop it, return 1e30 and stop it 348watcher, ever>. If you need to stop it, return 1e30 and stop it
348afterwards. 349afterwards.
349 350
… …
542 543
5431; 5441;
544 545
545=head1 SEE ALSO 546=head1 SEE ALSO
546 547
547 L<EV::DNS>, L<EV::AnyEvent>. 548 L<EV::DNS>.
548 549
549=head1 AUTHOR 550=head1 AUTHOR
550 551
551 Marc Lehmann <schmorp@schmorp.de> 552 Marc Lehmann <schmorp@schmorp.de>
552 http://home.schmorp.de/ 553 http://home.schmorp.de/

Diff Legend

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