TibrvTimer::create()

Method

Declaration

TibrvStatus create (
    TibrvQueue* queue,
    TibrvCallback* callback,
    tibrv_f64 interval,
    const void* closure = NULL);

Purpose

Start a timer.

Parameter	Description
`queue`	At each time interval, place the event on this event queue.
`callback`	On dispatch, process the event with this callback object. This object can be an instance of class TibrvTimerCallback, or its superclass TibrvCallback.
`interval`	The timer triggers its callback method at this repeating interval (in seconds).
`closure`	Store this closure data in the event object.

Remarks

This method creates a C timer, activates it, and stores its handle in the C++ object.

Timer Granularity

Express the timer interval (in seconds) as a 64-bit floating point number. This representation allows microsecond granularity for intervals for over 100 years. The actual granularity of intervals depends on hardware and operating system constraints.

Zero as Interval