NAME

       tickit_watch_later - invoke a callback at the next round of IO events

SYNOPSIS

       #include <tickit.h>

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

       void *tickit_watch_later(Tickit *t, TickitBindFlags flags,
           TickitCallbackFn *fn, void *user);

       Link with -ltickit.

DESCRIPTION

       tickit_watch_later()  registers  a  callback  function to be invoked by the toplevel event
       loop as it processes the next round of IO events. 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. 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  registered with the TICKIT_BIND_FIRST flag, the callback will be inserted at the start
       of the queue, coming before others. If not, it is appended at the end.

       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_later() returns an opaque identifier pointer.

SEE ALSO

       tickit_new_stdio(3),         tickit_watch_io(3),         tickit_watch_timer_after_msec(3),
       tickit_watch_timer_at_epoch(3),      tickit_watch_signal(3),      tickit_watch_process(3),
       tickit_watch_cancel(3), tickit(7)

                                                                            TICKIT_WATCH_LATER(3)