Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
IO::Async::Timer::AbsoUser(Contributed Perl DocumIO::Async::Timer::Absolute(3)

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[3]+1, $time[4], $time[5] ),

	     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>

perl v5.32.1			  2021-11-04	 IO::Async::Timer::Absolute(3)

NAME | SYNOPSIS | DESCRIPTION | EVENTS | PARAMETERS | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=IO::Async::Timer::Absolute&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help