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.198 by root, Thu Mar 26 20:17:44 2009 UTC vs.
Revision 1.199 by root, Fri Mar 27 10:49:50 2009 UTC

168=head2 I/O WATCHERS 168=head2 I/O WATCHERS
169 169
170You can create an I/O watcher by calling the C<< AnyEvent->io >> method 170You can create an I/O watcher by calling the C<< AnyEvent->io >> method
171with the following mandatory key-value pairs as arguments: 171with the following mandatory key-value pairs as arguments:
172 172
173C<fh> the Perl I<file handle> (I<not> file descriptor) to watch for events 173C<fh> is the Perl I<file handle> (I<not> file descriptor) to watch
174(AnyEvent might or might not keep a reference to this file handle). C<poll> 174for events (AnyEvent might or might not keep a reference to this file
175handle). Note that only file handles pointing to things for which
176non-blocking operation makes sense are allowed. This includes sockets,
177most character devices, pipes, fifos and so on, but not for example files
178or block devices.
179
175must be a string that is either C<r> or C<w>, which creates a watcher 180C<poll> must be a string that is either C<r> or C<w>, which creates a
176waiting for "r"eadable or "w"ritable events, respectively. C<cb> is the 181watcher waiting for "r"eadable or "w"ritable events, respectively.
182
177callback to invoke each time the file handle becomes ready. 183C<cb> is the callback to invoke each time the file handle becomes ready.
178 184
179Although the callback might get passed parameters, their value and 185Although the callback might get passed parameters, their value and
180presence is undefined and you cannot rely on them. Portable AnyEvent 186presence is undefined and you cannot rely on them. Portable AnyEvent
181callbacks cannot use arguments passed to I/O watcher callbacks. 187callbacks cannot use arguments passed to I/O watcher callbacks.
182 188
867no warnings; 873no warnings;
868use strict qw(vars subs); 874use strict qw(vars subs);
869 875
870use Carp; 876use Carp;
871 877
872our $VERSION = 4.341; 878our $VERSION = 4.35;
873our $MODEL; 879our $MODEL;
874 880
875our $AUTOLOAD; 881our $AUTOLOAD;
876our @ISA; 882our @ISA;
877 883

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines