Paul Evans > IO-Async-0.62 > IO::Async::Timer::Absolute

Download:
IO-Async-0.62.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  6
Open  7
View/Report Bugs
Module Version: 0.62   Source   Latest Release: IO-Async-0.64

NAME ^

IO::Async::Timer::Absolute - event callback at a fixed future time

SYNOPSIS ^

 use IO::Async::Timer::Absolute;

 use POSIX qw( mktime );

 use IO::Async::Loop;
 my $loop = IO::Async::Loop->new;

 my @time = gmtime;

 my $timer = IO::Async::Timer::Absolute->new(
    time => mktime( 0, 0, 0, $time[4]+1, $time[5], $time[6] ),

    on_expire => sub {
       print "It's midnight\n";
       $loop->stop;
    },
 );

 $loop->add( $timer );

 $loop->run;

DESCRIPTION ^

This subclass of IO::Async::Timer implements one-shot events at a fixed time in the future. The object waits for a given timestamp, and invokes its callback at that point in the future.

For a Timer object that waits for a delay relative to the time it is started, see instead IO::Async::Timer::Countdown.

EVENTS ^

The following events are invoked, either using subclass methods or CODE references in parameters:

on_expire

Invoked when the timer expires.

PARAMETERS ^

The following named parameters may be passed to new or configure:

on_expire => CODE

CODE reference for the on_expire event.

time => NUM

The epoch time at which the timer will expire.

Once constructed, the timer object will need to be added to the Loop before it will work.

Unlike other timers, it does not make sense to start this object, because its expiry time is absolute, and not relative to the time it is started.

AUTHOR ^

Paul Evans <leonerd@leonerd.org.uk>

syntax highlighting: