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

Comparing AnyEvent/lib/AnyEvent.pm (file contents):
Revision 1.32 by root, Sat Nov 3 09:29:51 2007 UTC vs.
Revision 1.40 by root, Mon Apr 7 19:00:55 2008 UTC

… …
70You can create I/O watcher by calling the C<< AnyEvent->io >> method with 70You can create I/O watcher by calling the C<< AnyEvent->io >> method with
71the following mandatory arguments: 71the following mandatory arguments:
72 72
73C<fh> the Perl I<filehandle> (not filedescriptor) to watch for 73C<fh> the Perl I<filehandle> (not filedescriptor) to watch for
74events. C<poll> must be a string that is either C<r> or C<w>, that creates 74events. C<poll> must be a string that is either C<r> or C<w>, that creates
75a watcher waiting for "r"eadable or "w"ritable events. C<cb> teh callback 75a watcher waiting for "r"eadable or "w"ritable events. C<cb> the callback
76to invoke everytime the filehandle becomes ready. 76to invoke everytime the filehandle becomes ready.
77 77
78Only one io watcher per C<fh> and C<poll> combination is allowed (i.e. on 78Only one io watcher per C<fh> and C<poll> combination is allowed (i.e. on
79a socket you can have one r + one w, not any more (limitation comes from 79a socket you can have one r + one w, not any more (limitation comes from
80Tk - if you are sure you are not using Tk this limitation is gone). 80Tk - if you are sure you are not using Tk this limitation is gone).
… …
109 my $w = AnyEvent->timer (after => 7.7, cb => sub { 109 my $w = AnyEvent->timer (after => 7.7, cb => sub {
110 warn "timeout\n"; 110 warn "timeout\n";
111 }); 111 });
112 112
113 # to cancel the timer: 113 # to cancel the timer:
114 undef $w 114 undef $w;
115 115
116=head2 CONDITION WATCHERS 116=head2 CONDITION WATCHERS
117 117
118Condition watchers can be created by calling the C<< AnyEvent->condvar >> 118Condition watchers can be created by calling the C<< AnyEvent->condvar >>
119method without any arguments. 119method without any arguments.
… …
197C<AnyEvent::Impl:xxx> modules, but can be any other class in the case 197C<AnyEvent::Impl:xxx> modules, but can be any other class in the case
198AnyEvent has been extended at runtime (e.g. in I<rxvt-unicode>). 198AnyEvent has been extended at runtime (e.g. in I<rxvt-unicode>).
199 199
200The known classes so far are: 200The known classes so far are:
201 201
202 AnyEvent::Impl::CoroEV based on Coro::EV, best choice.
202 EV::AnyEvent based on EV (an interface to libev, best choice) 203 AnyEvent::Impl::EV based on EV (an interface to libev, also best choice).
203 AnyEvent::Impl::Coro based on Coro::Event, second best choice. 204 AnyEvent::Impl::CoroEvent based on Coro::Event, second best choice.
204 AnyEvent::Impl::Event based on Event, also second best choice :) 205 AnyEvent::Impl::Event based on Event, also second best choice :)
205 AnyEvent::Impl::Glib based on Glib, second-best choice. 206 AnyEvent::Impl::Glib based on Glib, second-best choice.
206 AnyEvent::Impl::Tk based on Tk, very bad choice. 207 AnyEvent::Impl::Tk based on Tk, very bad choice.
207 AnyEvent::Impl::Perl pure-perl implementation, inefficient. 208 AnyEvent::Impl::Perl pure-perl implementation, inefficient.
208 209
… …
251no warnings; 252no warnings;
252use strict; 253use strict;
253 254
254use Carp; 255use Carp;
255 256
256our $VERSION = '2.55'; 257our $VERSION = '2.9';
257our $MODEL; 258our $MODEL;
258 259
259our $AUTOLOAD; 260our $AUTOLOAD;
260our @ISA; 261our @ISA;
261 262
262our $verbose = $ENV{PERL_ANYEVENT_VERBOSE}*1; 263our $verbose = $ENV{PERL_ANYEVENT_VERBOSE}*1;
263 264
264our @REGISTRY; 265our @REGISTRY;
265 266
266my @models = ( 267my @models = (
268 [Coro::EV:: => AnyEvent::Impl::CoroEV::],
269 [EV:: => AnyEvent::Impl::EV::],
267 [Coro::Event:: => AnyEvent::Impl::Coro::], 270 [Coro::Event:: => AnyEvent::Impl::CoroEvent::],
268 [EV:: => EV::AnyEvent::],
269 [Event:: => AnyEvent::Impl::Event::], 271 [Event:: => AnyEvent::Impl::Event::],
270 [Glib:: => AnyEvent::Impl::Glib::], 272 [Glib:: => AnyEvent::Impl::Glib::],
271 [Tk:: => AnyEvent::Impl::Tk::], 273 [Tk:: => AnyEvent::Impl::Tk::],
272 [AnyEvent::Impl::Perl:: => AnyEvent::Impl::Perl::], 274 [AnyEvent::Impl::Perl:: => AnyEvent::Impl::Perl::],
273); 275);
… …
303 last; 305 last;
304 } 306 }
305 } 307 }
306 308
307 $MODEL 309 $MODEL
308 or die "No event module selected for AnyEvent and autodetect failed. Install any one of these modules: Event (or Coro+Event), Glib or Tk."; 310 or die "No event module selected for AnyEvent and autodetect failed. Install any one of these modules: EV (or Coro+EV), Event (or Coro+Event), Glib or Tk.";
309 } 311 }
310 312
311 unshift @ISA, $MODEL; 313 unshift @ISA, $MODEL;
312 push @{"$MODEL\::ISA"}, "AnyEvent::Base"; 314 push @{"$MODEL\::ISA"}, "AnyEvent::Base";
313 } 315 }
… …
371 373
372# default implementation for ->child 374# default implementation for ->child
373 375
374our %PID_CB; 376our %PID_CB;
375our $CHLD_W; 377our $CHLD_W;
378our $CHLD_DELAY_W;
376our $PID_IDLE; 379our $PID_IDLE;
377our $WNOHANG; 380our $WNOHANG;
378 381
379sub _child_wait { 382sub _child_wait {
380 while (0 <= (my $pid = waitpid -1, $WNOHANG)) { 383 while (0 < (my $pid = waitpid -1, $WNOHANG)) {
381 $_->($pid, $?) for (values %{ $PID_CB{$pid} || {} }), 384 $_->($pid, $?) for (values %{ $PID_CB{$pid} || {} }),
382 (values %{ $PID_CB{0} || {} }); 385 (values %{ $PID_CB{0} || {} });
383 } 386 }
384 387
385 undef $PID_IDLE; 388 undef $PID_IDLE;
386} 389}
387 390
391sub _sigchld {
392 # make sure we deliver these changes "synchronous" with the event loop.
393 $CHLD_DELAY_W ||= AnyEvent->timer (after => 0, cb => sub {
394 undef $CHLD_DELAY_W;
395 &_child_wait;
396 });
397}
398
388sub child { 399sub child {
389 my (undef, %arg) = @_; 400 my (undef, %arg) = @_;
390 401
391 defined (my $pid = $arg{pid} + 0) 402 defined (my $pid = $arg{pid} + 0)
392 or Carp::croak "required option 'pid' is missing"; 403 or Carp::croak "required option 'pid' is missing";
… …
396 unless ($WNOHANG) { 407 unless ($WNOHANG) {
397 $WNOHANG = eval { require POSIX; &POSIX::WNOHANG } || 1; 408 $WNOHANG = eval { require POSIX; &POSIX::WNOHANG } || 1;
398 } 409 }
399 410
400 unless ($CHLD_W) { 411 unless ($CHLD_W) {
401 $CHLD_W = AnyEvent->signal (signal => 'CHLD', cb => \&_child_wait); 412 $CHLD_W = AnyEvent->signal (signal => 'CHLD', cb => \&_sigchld);
402 # child could be a zombie already 413 # child could be a zombie already, so make at least one round
403 $PID_IDLE ||= AnyEvent->timer (after => 0, cb => \&_child_wait); 414 &_sigchld;
404 } 415 }
405 416
406 bless [$pid, $arg{cb}], "AnyEvent::Base::Child" 417 bless [$pid, $arg{cb}], "AnyEvent::Base::Child"
407} 418}
408 419

Diff Legend

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