NAME

       tickit_watch_timer_after_* - invoke a callback after a fixed delay

SYNOPSIS

       #include <tickit.h>

       typedef int TickitCallbackFn(Tickit *t, TickitEventflags flags,
           void *info, void *user);

       void *tickit_watch_timer_after_msec(Tickit *t, int msec,
           TickitBindFlags flags, TickitCallbackFn *fn, void *user);
       void *tickit_watch_timer_after_tv(Tickit *t, const struct timeval *after,
           TickitBindFlags flags, TickitCallbackFn *fn, void *user);

       Link with -ltickit.

DESCRIPTION

       The  tickit_watch_timer_after_*()  family  of functions register a callback function to be invoked by the
       toplevel event loop a fixed delay afterwards. A registered callback will be invoked by a running call  to
       tickit_run(3).  The  callback function will be invoked once, and then destroyed afterwards. Each function
       returns an opaque pointer value which serves to identify this instance. The info pointer will be NULL.

       When invoked, the callback function is always passed both TICKIT_EV_FIRE and  TICKIT_EV_UNBIND  flags  to
       its  flags  argument. If the callback had been registered with the TICKIT_BIND_DESTROY flag, then it will
       also be invoked with the TICKIT_EV_DESTROY flag if it has not yet been invoked by the time  the  toplevel
       instance is destroyed.

       If  cancelled  by  tickit_watch_cancel(3) the callback function is invoked with just the TICKIT_EV_UNBIND
       flag if it had been registered with TICKIT_BIND_UNBIND.

RETURN VALUE

       tickit_watch_timer_after_msec() and tickit_watch_timer_after_tv() return an opaque identifier pointer.

SEE ALSO

       tickit_new_stdio(3),   tickit_watch_timer_at_epoch(3),   tickit_watch_later(3),   tickit_watch_cancel(3),
       tickit(7)

                                                                                TICKIT_WATCH_TIMER_AFTER_MSEC(3)