tickit_watch_later - invoke a callback at the next round of IO events
Contents
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.
Name
tickit_watch_later - invoke a callback at the next round of IO events
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)
Synopsis
#include<tickit.h>typedefintTickitCallbackFn(Tickit*t,TickitEventflagsflags,void*info,void*user);void*tickit_watch_later(Tickit*t,TickitBindFlagsflags,TickitCallbackFn*fn,void*user);
Link with -ltickit.
