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

Comparing EV/EV.pm (file contents):
Revision 1.135 by root, Mon Dec 12 16:32:24 2011 UTC vs.
Revision 1.143 by root, Fri Apr 11 04:27:20 2014 UTC

… …
119package EV; 119package EV;
120 120
121use common::sense; 121use common::sense;
122 122
123BEGIN { 123BEGIN {
124 our $VERSION = '4.03'; 124 our $VERSION = '4.17';
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 =
… …
290=item $backend = $loop->backend 291=item $backend = $loop->backend
291 292
292Returns an integer describing the backend used by libev (EV::BACKEND_SELECT 293Returns an integer describing the backend used by libev (EV::BACKEND_SELECT
293or EV::BACKEND_EPOLL). 294or EV::BACKEND_EPOLL).
294 295
295=item EV::run [$flags] 296=item $active = EV::run [$flags]
296 297
297=item $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. 301callback calls EV::unloop or the flasg are nonzero (in which case the
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
304false. The returnv alue can generally be interpreted as "if true, there is
305more work left to do".
301 306
302The $flags argument can be one of the following: 307The $flags argument can be one of the following:
303 308
304 0 as above 309 0 as above
305 EV::RUN_ONCE block at most once (wait, but do not loop) 310 EV::RUN_ONCE block at most once (wait, but do not loop)
… …
677time: 682time:
678 683
679 my $hourly = EV::periodic 0, 3600, 0, sub { print "once/hour\n" }; 684 my $hourly = EV::periodic 0, 3600, 0, sub { print "once/hour\n" };
680 685
681That doesn't mean there will always be 3600 seconds in between triggers, 686That doesn't mean there will always be 3600 seconds in between triggers,
682but only that the the clalback will be called when the system time shows a 687but only that the the callback will be called when the system time shows a
683full hour (UTC). 688full hour (UTC).
684 689
685Another way to think about it (for the mathematically inclined) is that 690Another way to think about it (for the mathematically inclined) is that
686EV::periodic will try to run the callback in this mode at the next 691EV::periodic will try to run the callback in this mode at the next
687possible time where C<$time = $at (mod $interval)>, regardless of any time 692possible time where C<$time = $at (mod $interval)>, regardless of any time
… …
1135 1140
1136=item $w = EV::async $callback 1141=item $w = EV::async $callback
1137 1142
1138=item $w = EV::async_ns $callback 1143=item $w = EV::async_ns $callback
1139 1144
1145=item $w = $loop->async ($callback)
1146
1147=item $w = $loop->async_ns ($callback)
1148
1140=item $w->send 1149=item $w->send
1141 1150
1142=item $bool = $w->async_pending 1151=item $bool = $w->async_pending
1143 1152
1144=back 1153=back
1154
1155=head3 CLEANUP WATCHERS - how to clean up when the event loop goes away
1156
1157Cleanup watchers are not supported on the Perl level, they can only be
1158used via XS currently.
1145 1159
1146 1160
1147=head1 PERL SIGNALS 1161=head1 PERL SIGNALS
1148 1162
1149While Perl signal handling (C<%SIG>) is not affected by EV, the behaviour 1163While Perl signal handling (C<%SIG>) is not affected by EV, the behaviour

Diff Legend

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