io::async::timer(3pm) [debian man page]

IO::Async::Timer(3pm)					User Contributed Perl Documentation				     IO::Async::Timer(3pm)

NAME

       "IO::Async::Timer" - base class for Notifiers that use timed delays

DESCRIPTION

       This module provides a subclass of IO::Async::Notifier for implementing notifiers that use timed delays. For specific implementations, see
       one of the subclasses:

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

       o       IO::Async::Timer::Countdown - event callback after a fixed delay

       o       IO::Async::Timer::Periodic - event callback at regular intervals

CONSTRUCTOR

   $timer = IO::Async::Timer->new( %args )
       Constructs a particular subclass of "IO::Async::Timer" object, and returns it. This constructor is provided for backward compatibility to
       older code which doesn't use the subclasses. New code should directly construct a subclass instead.

       mode => STRING
	       The type of timer to create. Currently the only allowed mode is "countdown" but more types may be added in the future.

       Once constructed, the "Timer" will need to be added to the "Loop" before it will work. It will also need to be started by the "start"
       method.

METHODS

   $running = $timer->is_running
       Returns true if the Timer has been started, and has not yet expired, or been stopped.

   $timer->start
       Starts the Timer. Throws an error if it was already running.

       If the Timer is not yet in a Loop, the actual start will be deferred until it is added. Once added, it will be running, and will expire at
       the given duration after the time it was added.

       As a convenience, $timer is returned. This may be useful for starting timers at construction time:

	$loop->add( IO::Async::Timer->new( ... )->start );

   $timer->stop
       Stops the Timer if it is running. If it has not yet been added to the "Loop" but there is a start pending, this will cancel it.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

perl v5.14.2							    2012-10-24						     IO::Async::Timer(3pm)

pod::Prima::Timer(3)					User Contributed Perl Documentation				      pod::Prima::Timer(3)

NAME

       Prima::Timer - programmable periodical events

SYNOPSIS

	   my $timer = Prima::Timer-> create(
	       timeout => 1000, # milliseconds
	       onTick  => sub {
		  print "tick!
";
	       },
	   );

	   $timer-> start;

DESCRIPTION

       Prima::Timer arranges periodical notifications to be delivered in certain time intervals.  The notifications are triggered by the system,
       and are seen as "Tick" events. There can be many active Timer objects at one time, spawning events simultaneously.

USAGE

       Prima::Timer is a descendant of Prima::Component.  Objects of Prima::Timer class are created in standard fashion:

	 my $t = Prima::Timer-> create(
	    timeout => 1000,
	    onTick  => sub { print "tick
"; },
	 );
	 $t-> start;

       If no `owner` is given, $::application is assumed.

       Timer objects are created in inactive state; no events are spawned. To start spawning events, <start()> method must be explicitly called.
       Time interval value is assigned using the <::timeout> property in milliseconds.

       When the system generates timer event, no callback is called immediately, - an event is pushed into stack instead, to be delivered during
       next event loop.  Therefore, timeout value is not held accurately, and events may take longer time to pass. More accurate timing scheme, as
       well as timing with precision less than a millisecond, is not supported by the toolkit.

API

   Properties
       timeout MILLISECONDS
	   Manages time interval between "Tick" events.  In set-mode call, if the timer is in active state ( see "get_active()", the new timeout
	   value is applied immediately.

   Methods
       get_active
	   Returns a boolean flag, whether object is in active state or not. In the active state "Tick" events are spawned after "::timeout" time
	   intervals.

       get_handle
	   Returns a system-dependent handle of object

       start
	   Sets object in active state. If succeed, or if the object is already in active state, returns 1. If the system was unable to create a
	   system timer instance, 0 is returned.

       stop
	   Sets object in inactive state.

   Events
       Tick
	   A system generated event, spawned every "::timeout" milliseconds if object is in active state.

AUTHOR

       Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

       Prima, Prima::Object

perl v5.14.2							    2009-02-24						      pod::Prima::Timer(3)