-
-
21 Oct 2021 11:53:53 UTC
- Distribution: Mojolicious
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (1961 / 52 / 38)
- Kwalitee
Bus factor: 6- 90.53% Coverage
- License: artistic_2
- Perl: v5.16.0
- Activity
24 month- Tools
- Download (821.64KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
NAME
Mojo::Reactor::Poll - Low-level event reactor with poll support
SYNOPSIS
use Mojo::Reactor::Poll; # Watch if handle becomes readable or writable my $reactor = Mojo::Reactor::Poll->new; $reactor->io($first => sub ($reactor, $writable) { say $writable ? 'First handle is writable' : 'First handle is readable'; }); # Change to watching only if handle becomes writable $reactor->watch($first, 0, 1); # Turn file descriptor into handle and watch if it becomes readable my $second = IO::Handle->new_from_fd($fd, 'r'); $reactor->io($second => sub ($reactor, $writable) { say $writable ? 'Second handle is writable' : 'Second handle is readable'; })->watch($second, 1, 0); # Add a timer $reactor->timer(15 => sub ($reactor) { $reactor->remove($first); $reactor->remove($second); say 'Timeout!'; }); # Start reactor if necessary $reactor->start unless $reactor->is_running;
DESCRIPTION
Mojo::Reactor::Poll is a low-level event reactor based on IO::Poll.
EVENTS
Mojo::Reactor::Poll inherits all events from Mojo::Reactor.
METHODS
Mojo::Reactor::Poll inherits all methods from Mojo::Reactor and implements the following new ones.
again
$reactor->again($id); $reactor->again($id, 0.5);
Restart timer and optionally change the invocation time. Note that this method requires an active timer.
io
$reactor = $reactor->io($handle => sub {...});
Watch handle for I/O events, invoking the callback whenever handle becomes readable or writable.
# Callback will be executed twice if handle becomes readable and writable $reactor->io($handle => sub ($reactor, $writable) { say $writable ? 'Handle is writable' : 'Handle is readable'; });
is_running
my $bool = $reactor->is_running;
Check if reactor is running.
next_tick
my $undef = $reactor->next_tick(sub {...});
Execute callback as soon as possible, but not before returning or other callbacks that have been registered with this method, always returns
undef
.one_tick
$reactor->one_tick;
Run reactor until an event occurs or no events are being watched anymore.
# Don't block longer than 0.5 seconds my $id = $reactor->timer(0.5 => sub {}); $reactor->one_tick; $reactor->remove($id);
recurring
my $id = $reactor->recurring(0.25 => sub {...});
Create a new recurring timer, invoking the callback repeatedly after a given amount of time in seconds.
remove
my $bool = $reactor->remove($handle); my $bool = $reactor->remove($id);
Remove handle or timer.
reset
$reactor->reset;
Remove all handles and timers.
start
$reactor->start;
Start watching for I/O and timer events, this will block until "stop" is called or no events are being watched anymore.
# Start reactor only if it is not running already $reactor->start unless $reactor->is_running;
stop
$reactor->stop;
Stop watching for I/O and timer events.
timer
my $id = $reactor->timer(0.5 => sub {...});
Create a new timer, invoking the callback after a given amount of time in seconds.
watch
$reactor = $reactor->watch($handle, $readable, $writable);
Change I/O events to watch handle for with true and false values. Note that this method requires an active I/O watcher.
# Watch only for readable events $reactor->watch($handle, 1, 0); # Watch only for writable events $reactor->watch($handle, 0, 1); # Watch for readable and writable events $reactor->watch($handle, 1, 1); # Pause watching for events $reactor->watch($handle, 0, 0);
SEE ALSO
Module Install Instructions
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm Mojolicious
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.