The Timer class represents a timer that fires after an expiration time, and then fires at an interval. When a Timer fires, it calls the apply method of the TimerNotify object that was passed to it when it was created.
The following example waits 5 seconds and then fires every 2 seconds, and when it fires the TimerNotify object prints how many times it has been called:
use "time"
actor Main
new create(env: Env) =>
let timers = Timers
let timer = Timer(Notify(env), 5_000_000_000, 2_000_000_000)
timers(consume timer)
class Notify is TimerNotify
let _env: Env
var _counter: U32 = 0
new iso create(env: Env) =>
_env = env
fun ref apply(timer: Timer, count: U64): Bool =>
_env.out.print(_counter.string())
_counter = _counter + 1
true
class ref Timer
Create a new timer. The expiration time should be a nanosecond count until the first expiration. The interval should also be in nanoseconds.
new iso create( notify: TimerNotify iso, expiration: U64 val, interval: U64 val = 0) : Timer iso^
Creates a new timer with an absolute expiration time rather than a relative time. The expiration time is wall-clock adjusted system time.
new ref abs( notify: TimerNotify ref, expiration: (I64 val , I64 val), interval: U64 val = 0) : Timer ref^
Remove the timer from any list.
fun ref _cancel() : None val
Returns the list node pointing to the timer. Used to schedule the timer in a queue.
fun ref _get_node() : ListNode[Timer ref] ref
Apply slop bits to the expiration time and interval. This reduces the precision by the given number of bits, effectively quantizing time.
fun ref _slop( bits: USize val) : None val
A timer is fired if its expiration time is in the past. The notifier is called with a count based on the elapsed time since expiration and the timer interval. The expiration time is set to the next expiration. Returns true if the timer should be rescheduled, false otherwise.
fun ref _fire( current: U64 val) : Bool val
Returns the next expiration time.
fun box _next() : U64 val
Converts a wall-clock adjusted system time to absolute expiration time
fun tag _abs_expiration_time( wall: (I64 val , I64 val)) : U64 val
© 2016-2018, The Pony Developers
© 2014-2015, Causality Ltd.
Licensed under the BSD 2-Clause License.
https://stdlib.ponylang.io/time-Timer