Mojo::IOWatcher(3) User Contributed Perl Documentation Mojo::IOWatcher(3)NAMEMojo::IOWatcher - Non-Blocking I/O Watcher
SYNOPSIS
use Mojo::IOWatcher;
# Watch if I/O handles become readable or writable
my $watcher = Mojo::IOWatcher->new;
$watcher->add($handle, on_readable => sub {
my ($watcher, $handle) = @_;
...
});
# Use timers
$watcher->timer(15 => sub {
my $watcher = shift;
$watcher->remove($handle);
print "Timeout!\n";
});
# And loop!
$watcher->one_tick('0.25') while 1;
DESCRIPTIONMojo::IOWatcher is a minimalistic non-blocking I/O watcher and the
foundation of Mojo::IOLoop. Mojo::IOWatcher::EV is a good example for
its extensibility. Note that this module is EXPERIMENTAL and might
change without warning!
METHODSMojo::IOWatcher inherits all methods from Mojo::Base and implements the
following new ones.
"add"
$watcher = $watcher->add($handle, on_readable => sub {...});
Add handles and watch for I/O events.
These options are currently available:
"on_readable"
Callback to be invoked once the handle becomes readable.
"on_writable"
Callback to be invoked once the handle becomes writable.
"cancel"
my $success = $watcher->cancel($id);
Cancel timer.
"detect"
my $class = Mojo::IOWatcher->detect;
Detect and load the best watcher implementation available, will try the
value of the "MOJO_IOWATCHER" environment variable or
Mojo::IOWatcher::EV. Note that this method is EXPERIMENTAL and might
change without warning!
"is_readable"
my $readable = $watcher->is_readable($handle);
Quick check if a handle is readable, useful for identifying tainted
sockets.
"not_writing"
$watcher = $watcher->not_writing($handle);
Only watch handle for readable events.
"one_tick"
$watcher->one_tick('0.25');
Run for exactly one tick and watch for I/O and timer events.
"recurring"
my $id = $watcher->recurring(3 => sub {...});
Create a new recurring timer, invoking the callback repeatedly after a
given amount of seconds.
"remove"
$watcher = $watcher->remove($handle);
Remove handle.
"timer"
my $id = $watcher->timer(3 => sub {...});
Create a new timer, invoking the callback after a given amount of
seconds.
"writing"
$watcher = $watcher->writing($handle);
Watch handle for readable and writable events.
DEBUGGING
You can set the "MOJO_IOWATCHER_DEBUG" environment variable to get some
advanced diagnostics information printed to "STDERR".
MOJO_IOWATCHER_DEBUG=1
SEE ALSO
Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.
perl v5.14.1 2011-09-01 Mojo::IOWatcher(3)