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

Comparing EV/EV.pm (file contents):
Revision 1.38 by root, Mon Nov 12 21:51:14 2007 UTC vs.
Revision 1.39 by root, Tue Nov 13 03:12:52 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
… …
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

Diff Legend

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